V2 Prospects Contact Information Enrich
curl --request POST \
--url https://api.explorium.ai/v2/prospects/contact_information/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"prospect_ids": [
"ee936e451b50c70e068e1b54e106cb89173198c4"
]
}
'import requests
url = "https://api.explorium.ai/v2/prospects/contact_information/enrich"
payload = { "prospect_ids": ["ee936e451b50c70e068e1b54e106cb89173198c4"] }
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({prospect_ids: ['ee936e451b50c70e068e1b54e106cb89173198c4']})
};
fetch('https://api.explorium.ai/v2/prospects/contact_information/enrich', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.explorium.ai/v2/prospects/contact_information/enrich",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prospect_ids' => [
'ee936e451b50c70e068e1b54e106cb89173198c4'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.explorium.ai/v2/prospects/contact_information/enrich"
payload := strings.NewReader("{\n \"prospect_ids\": [\n \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/prospects/contact_information/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prospect_ids\": [\n \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/prospects/contact_information/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prospect_ids\": [\n \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"prospect_id": "<string>",
"data": {
"professional_email": "<string>",
"professional_email_status": "valid",
"phone_numbers": [
{}
],
"mobile_phone": "<string>",
"hashed_personal_emails": [
"<string>"
],
"hashed_professional_emails": [
"<string>"
]
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Sync
Contact information
POST
/
v2
/
prospects
/
contact_information
/
enrich
V2 Prospects Contact Information Enrich
curl --request POST \
--url https://api.explorium.ai/v2/prospects/contact_information/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"prospect_ids": [
"ee936e451b50c70e068e1b54e106cb89173198c4"
]
}
'import requests
url = "https://api.explorium.ai/v2/prospects/contact_information/enrich"
payload = { "prospect_ids": ["ee936e451b50c70e068e1b54e106cb89173198c4"] }
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({prospect_ids: ['ee936e451b50c70e068e1b54e106cb89173198c4']})
};
fetch('https://api.explorium.ai/v2/prospects/contact_information/enrich', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.explorium.ai/v2/prospects/contact_information/enrich",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prospect_ids' => [
'ee936e451b50c70e068e1b54e106cb89173198c4'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.explorium.ai/v2/prospects/contact_information/enrich"
payload := strings.NewReader("{\n \"prospect_ids\": [\n \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/prospects/contact_information/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prospect_ids\": [\n \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/prospects/contact_information/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prospect_ids\": [\n \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"prospect_id": "<string>",
"data": {
"professional_email": "<string>",
"professional_email_status": "valid",
"phone_numbers": [
{}
],
"mobile_phone": "<string>",
"hashed_personal_emails": [
"<string>"
],
"hashed_professional_emails": [
"<string>"
]
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Introduction
The Contact details enrichments API provides detailed information about individual prospects, including contact details, professional emails, and phone numbers. This API is crucial for lead enrichment, personalized outreach, and enhancing sales intelligence workflows. Key Benefits:- Access validated contact information for prospects.
- Get SHA256-hashed email identifiers (professional and personal) for ABM and ad-audience matching, without handling plain-text addresses.
- Ensure accurate and up-to-date data for prospecting and engagement.
Endpoint: POST /prospects/contact_information/enrich
v2: this endpoint accepts either a single ID (a string) or a list of up to 50 IDs — the separate
/bulk_enrich route is gone. See v2 conventions.Enrich by prospect details instead of IDs
prospect_ids is the primary way to call this endpoint. If you don’t have Explorium IDs yet, you can send prospects_to_match instead: up to 50 people, described with the same fields the Match prospects endpoint accepts (full_name, company_name, email, phone_number, linkedin, business_id). Each person is matched and enriched in the same call. Send either prospect_ids or prospects_to_match, never both (that returns a 422). Any parameters the endpoint takes work the same either way.
{
"prospects_to_match": [
{ "full_name": "Jane Doe", "company_name": "Acme Corp" },
{ "full_name": "John Smith", "company_name": "Unknown Co" }
]
}
{
"response_context": {
"correlation_id": "9a1c0e7f4b2d4c6e8f0a1b2c3d4e5f60",
"request_status": "success",
"time_taken_in_seconds": 1.42
},
"data": [
{
"input": { "business_id": null, "full_name": "Jane Doe", "company_name": "Acme Corp", "email": null, "phone_number": null, "linkedin": null },
"prospect_id": "4f1d9c2e7a3b5c8d0e6f1a2b3c4d5e6f7a8b9c0d",
"data": { "...": "same fields as an ID-based request" },
"warnings": []
},
{
"input": { "business_id": null, "full_name": "John Smith", "company_name": "Unknown Co", "email": null, "phone_number": null, "linkedin": null },
"prospect_id": null,
"data": null,
"warnings": []
}
],
"total_results": 1,
"total_matches": 1
}
input and returns the matched prospect_id. People who don’t match come back with prospect_id: null and data: null, and aren’t charged. total_matches counts the matched rows.
Need higher coverage? The asynchronous variant supports waterfall enrichment — prospects that Explorium data cannot enrich are retried against a verified external provider. The
waterfall parameter is available only on the async endpoint; passing it here returns a validation error.How It Works
How It Works
- Input: Provide a
prospect_id(retrieved from the Match Prospects endpoint) to retrieve enrichment details. - Processing: The system scans and fetches available data from multiple sources.
- Output: A structured response containing the professional email, phone numbers, and mobile number.
Request Schema
Request Schema
| Field | Type | Description |
|---|---|---|
prospect_id | String | A unique identifier for the prospect (Required) |
Best Practices
Best Practices
- Use verified prospect IDs for accurate enrichment.
- Cross-check multiple contact points to reach prospects effectively.
- Store enriched data in CRM for seamless sales workflows.
- Update prospect details regularly to maintain accuracy in outreach campaigns.
Contacts Information Output Signal
Contacts Information Output Signal
| Signal | API Name | Description | Data Type Final |
|---|---|---|---|
| professional_email_status | Individual’s professional email validity status | Recommended validity status for the listed ‘Professional email’ address. Returns one of the following possible values: ‘valid’ emails are determined as safe to email, ‘invalid’ emails are addresses we recommend to erase from mailing lists, ‘catch-all’ emails are created as a precaution by domain owners. For recommendations on how best to use ‘catch all’ emails, read more on our resource center page ‘Email validation: catch-all domains’. | object |
| professional_email | Individual’s professional email | Current professional email address associated with the individual | string |
| mobile_phone | Individual’s mobile phone | Individual’s direct dial mobile phone number. | string |
| phone_numbers | Individual’s phone numbers | List of all phone numbers associated with the individual. | array |
| hashed_professional_emails | Individual’s hashed professional emails | SHA256 hashes (64-character hex) of the individual’s professional email addresses. Returned only when contact_types includes hashed_identifiers; null when none. | |
| hashed_personal_emails | Individual’s hashed personal emails | SHA256 hashes (64-character hex) of the individual’s personal email addresses. Returned only when contact_types includes hashed_identifiers; null when none. |
Hashed identifiers for ABM
Addhashed_identifiers to contact_types to get each prospect’s email addresses as SHA256 hashes, split into hashed_professional_emails and hashed_personal_emails. Hashed emails are the format ad platforms and ABM tools use to match audiences, so you can build and sync account-based audiences without handling plain-text addresses.
- Cost: 1 credit per prospect returned with hashed identifiers. Email (2 credits) and phone (5 credits) are charged as usual when requested in the same call.
- Opt-in: hashed identifiers are returned only when you request them. Omitting
parametersreturns email and phone, as before. - Gmail addresses are hashed twice, as written and with the dots in the name removed (
jane.doe@gmail.com→janedoe@gmail.com), so both variants are in the array. - No emails: both arrays are
nullwhen the prospect has no email on record.
Response row with hashed identifiers
{
"prospect_id": "4f1d9c2e7a3b5c8d0e6f1a2b3c4d5e6f7a8b9c0d",
"data": {
"hashed_professional_emails": ["9f2c3a51e0b44d7a8c6e1f3b2d5a7c9e0f1b3d5a7c9e1f3b5d7a9c1e3f5b7d9a"],
"hashed_personal_emails": null
}
}
Body Params - Try Me Example
prospect_ids: ee936e451b50c70e068e1b54e106cb89173198c4
{
"prospect_ids": "ee936e451b50c70e068e1b54e106cb89173198c4",
"parameters": {
"contact_types": ["email"]
}
}
{
"prospect_ids": "ee936e451b50c70e068e1b54e106cb89173198c4",
"parameters": {
"contact_types": ["phone"]
}
}
{
"prospect_ids": "ee936e451b50c70e068e1b54e106cb89173198c4",
"parameters": {
"contact_types": ["email", "phone"]
}
}
{
"prospect_ids": "ee936e451b50c70e068e1b54e106cb89173198c4",
"parameters": {
"contact_types": ["hashed_identifiers"]
}
}
{
"prospect_ids": "ee936e451b50c70e068e1b54e106cb89173198c4",
"parameters": {
"contact_types": ["email", "hashed_identifiers"]
}
}
prospect_ids: ee936e451b50c70e068e1b54e106cb89173198c4
Body
application/json
- V2ProspectContactInformationEnrichRequest
- V2ProspectContactInformationEnrichRequest
Provide exactly one of prospect_ids or prospects_to_match; at most 50 entities.
Response
Successful Response
- V2ProspectEnrichResponse[V2ContactsInformationOutputSchema]
- V2ProspectMatchEnrichResponse[V2ContactsInformationOutputSchema]
This is base response model for all responses in partner service.
Was this page helpful?