Enrichment API
Bulk Contact Enrichment Results
This endpoint allows users to retrieve the results of a completed bulk contact enrichment job,
which was initiated via the /contacts endpoint. After submitting a batch of contacts for enrichment,
users can access the processed data from this URL. The results will be returned in JSON format and will include
details for each contact that was processed. Note that after the expiration date, the results will no longer
be available, and the data will be permanently deleted. This endpoint allows users to retrieve the results
of a completed bulk contact enrichment job. After submitting a batch of contacts for verification,
users can access the processed data from this URL. The results will be available in JSON format
and will include details for each contact that was processed.
Request
GET
/contacts/results/{job_id}.json
job_idstringrequiredin path
A unique identifier for the background process handling the bulk enrichment request.
Example:
e01f423b-70f8-4911-93c7-97a07155354e
Response
200
202
400
401
403
404
429
Bulk Contact Enrichment Results.
contactsarrayrequired
An array containing the enriched contact data.
Each contact in the array represents a processed
result with details such as email, mobile_phone, title, company, etc.
companyobjectrequired
Detailed information about the company where the contact is employed.
Includes the company’s name, description, website, location, and other key attributes.
credit_chargedbooleanrequired
Credit charged for email OR contact phone OR Mobile phone.
Example:
true
custom_fieldsobject
A dictionary of custom metadata associated with the company.
This can include fields like Salesforce IDs, external IDs, or other user-defined data.
Example:
{"id":"id_123","salesforce_key":"key_123"}
departmentstringrequired
The department where the contact works. Provides insight into the specific division or function of the individual’s role.
Example:
General Management
emailstringrequired
The contact's professional email address. Essential for direct communication and correspondence with the individual.
Example:
john.doe@example.com
errorstringrequired
Reason of error if contact is not enriched.
Example:
You have run out of API credits. Some of the submitted records were not enriched. Please contact support to purchase more credits.
first_namestringrequired
The first name of the contact. This identifies the individual's personal name for more specific searches and personalization.
Example:
John
job_levelstringrequired
The hierarchical level of the contact’s position. Shows the seniority and rank of the individual within the organization.
Example:
Executive
last_namestringrequired
The last name of the contact. Provides the surname for precise identification and to complement the first name.
Example:
Doe
linkedinstringrequired
The URL to the contact’s LinkedIn profile. Offers a link to their professional networking page for more details and connections.
Example:
https://www.linkedin.com/in/johndoe
locationobjectrequired
The contact’s physical address details including country, state, and zip code. Provides geographic context about the individual’s location.
mobile_phonestringrequired
The contact's mobile phone number. Allows for personal communication with the individual on their mobile device.
Example:
+18005555678
office_phonestringrequired
The contact's office telephone number. Used for reaching the individual at their business location.
Example:
+18005551234
original_fieldsobject
An object containing the original fields passed by the user in the initial request.
This ensures that users can cross-reference the enriched data with their original input.
Example:
{"first_name":"John","last_name":"Doe","email":"john.doe@example.com"}
titlestringrequired
The contact’s job title. Indicates the individual’s position or role within their organization.
Example:
Chief Executive Officer
remaining_creditsnumberrequired
The number of credits remaining after the bulk contact enrichment operation.
This indicates how many more enrichment requests the user can make.
Example:
999999
Request Sample
curl -X GET "https://api.selling.com/contacts/results/e01f423b-70f8-4911-93c7-97a07155354e.json" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json"Response Sample
{
"contacts": [
{
"error": "You have run out of API credits. Some of the submitted records were not enriched. Please contact support to purchase more credits.",
"credit_charged": true,
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"office_phone": "+18005551234",
"mobile_phone": "+18005555678",
"location": {
"country": "United States",
"state": "California",
"zip_code": "90001"
},
"title": "Chief Executive Officer",
"job_level": "Executive",
"department": "General Management",
"linkedin": "https://www.linkedin.com/in/johndoe",
"company": {
"name": "ExampleCorp",
"description": "ExampleCorp is a leading provider of business solutions...",
"website": "https://example.com",
"employees_category": "500-1,000",
"revenue_category": "$10 – 49 M",
"location": {
"country": "United States",
"state": "California",
"zip_code": "90001"
}
},
"original_fields": {
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com"
},
"custom_fields": {
"id": "id_123",
"salesforce_key": "key_123"
}
}
],
"remaining_credits": 999999
}