Contacts Information
curl --request POST \
--url https://api.explorium.ai/v1/prospects/contacts_information/bulk_enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"prospect_ids": [
"<string>"
],
"request_context": null,
"parameters": {
"contact_types": []
}
}
'import requests
url = "https://api.explorium.ai/v1/prospects/contacts_information/bulk_enrich"
payload = {
"prospect_ids": ["<string>"],
"request_context": None,
"parameters": { "contact_types": [] }
}
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: ['<string>'],
request_context: null,
parameters: {contact_types: []}
})
};
fetch('https://api.explorium.ai/v1/prospects/contacts_information/bulk_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/v1/prospects/contacts_information/bulk_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' => [
'<string>'
],
'request_context' => null,
'parameters' => [
'contact_types' => [
]
]
]),
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/v1/prospects/contacts_information/bulk_enrich"
payload := strings.NewReader("{\n \"prospect_ids\": [\n \"<string>\"\n ],\n \"request_context\": null,\n \"parameters\": {\n \"contact_types\": []\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/v1/prospects/contacts_information/bulk_enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prospect_ids\": [\n \"<string>\"\n ],\n \"request_context\": null,\n \"parameters\": {\n \"contact_types\": []\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v1/prospects/contacts_information/bulk_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 \"<string>\"\n ],\n \"request_context\": null,\n \"parameters\": {\n \"contact_types\": []\n }\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_took_in_seconds": 123
},
"total_results": 123,
"data": [
{
"prospect_id": "<string>",
"data": {
"emails": [
{}
],
"professions_email": "<string>",
"professional_email_status": "valid",
"phone_numbers": [
{}
],
"mobile_phone": "<string>"
}
}
],
"entity_id": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Prospects Bulk Enrichments
Contact details (Bulk)
POST
/
v1
/
prospects
/
contacts_information
/
bulk_enrich
Contacts Information
curl --request POST \
--url https://api.explorium.ai/v1/prospects/contacts_information/bulk_enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"prospect_ids": [
"<string>"
],
"request_context": null,
"parameters": {
"contact_types": []
}
}
'import requests
url = "https://api.explorium.ai/v1/prospects/contacts_information/bulk_enrich"
payload = {
"prospect_ids": ["<string>"],
"request_context": None,
"parameters": { "contact_types": [] }
}
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: ['<string>'],
request_context: null,
parameters: {contact_types: []}
})
};
fetch('https://api.explorium.ai/v1/prospects/contacts_information/bulk_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/v1/prospects/contacts_information/bulk_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' => [
'<string>'
],
'request_context' => null,
'parameters' => [
'contact_types' => [
]
]
]),
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/v1/prospects/contacts_information/bulk_enrich"
payload := strings.NewReader("{\n \"prospect_ids\": [\n \"<string>\"\n ],\n \"request_context\": null,\n \"parameters\": {\n \"contact_types\": []\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/v1/prospects/contacts_information/bulk_enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prospect_ids\": [\n \"<string>\"\n ],\n \"request_context\": null,\n \"parameters\": {\n \"contact_types\": []\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v1/prospects/contacts_information/bulk_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 \"<string>\"\n ],\n \"request_context\": null,\n \"parameters\": {\n \"contact_types\": []\n }\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_took_in_seconds": 123
},
"total_results": 123,
"data": [
{
"prospect_id": "<string>",
"data": {
"emails": [
{}
],
"professions_email": "<string>",
"professional_email_status": "valid",
"phone_numbers": [
{}
],
"mobile_phone": "<string>"
}
}
],
"entity_id": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Description
The Bulk Contact Details Enrichment API allows users to retrieve verified data for multiple prospects in a single request. This endpoint enhances lead intelligence by providing accurate emails, phone numbers, and mobile numbers at scale. Key Benefits:- Bulk retrieval of enriched contact data for up to 50 prospects per request.
- Enhance outreach with validated professional and personal contact details.
- Optimize lead engagement by leveraging multiple verified data points.
How It Works
How It Works
- Input: Provide up to 50
prospect_idvalues, obtained from the Match Prospects endpoint. - Processing: The system retrieves verified contact information, including emails and phone numbers.
- Output: Returns structured data in the same order as the input, ensuring easy mapping.
Request Schema
Request Schema
| Field | Type | Description |
|---|---|---|
prospect_ids | Array | A list of up to 50 unique prospect IDs (Required) |
Example Request (cURL)
Example Request (cURL)
Bash
curl --request POST \
--url https://api.explorium.ai/v1/prospects/contacts_information/bulk_enrich \
--header 'accept: application/json' \
--header 'api_key: <your_api_key>' \
--header 'content-type: application/json' \
--data '{
"prospect_ids": [
"ee936e451b50c70e068e1b54e106cb89173198c4",
"d668424ab4f6aaeeeb74248d56b8335383fd522b"
]
}'
Example Response
Example Response
JSON
{
"response_context": {
"correlation_id": "f6bf2bf8c0e34f3d9fa000f83398c97b",
"request_status": "success",
"time_took_in_seconds": 0.733
},
"data": [
{
"prospect_id": "ee936e451b50c70e068e1b54e106cb89173198c4",
"data": {
"emails": [
{
"address": "satyanadella@hotmail.com",
"type": "personal"
},
{
"address": "satyan@microsoft.com",
"type": "professional"
}
],
"phone_numbers": [
{
"phone_number": "+14258828080"
},
{
"phone_number": "+14255032236"
}
],
"mobile_phone": "+14255032236"
}
},
{
"prospect_id": "57f9e5dac64d31d80e6e9432fe2c500d0bba2c01",
"data": {
"emails": [
{
"address": "lorihuang@hotmail.com",
"type": "personal"
},
{
"address": "jensenh@nvidia.com",
"type": "current_professional"
}
],
"phone_numbers": [
{
"phone_number": "+14156991685"
},
{
"phone_number": "+13172018718"
}
],
"mobile_phone": "+14156991685"
}
}
],
"total_results": 2
}
Best Practices
Best Practices
- Batch process multiple prospect IDs to improve efficiency and reduce API calls.
- Ensure valid prospect IDs are used to maximize data accuracy.
- Leverage enriched contact data to refine lead scoring and improve outreach.
- Regularly update CRM records with the latest contact details.
Bulk Contacts Enrichment Output Signals
Bulk Contacts Enrichment Output Signals
| 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 |
| emails | Individual’s emails | List of all email addresses associated with the individual labeled as a professional or personal email address. | array |
| professions_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 |
Body Params - Try Me Example
prospect_ids: ee936e451b50c70e068e1b54e106cb89173198c4,
57f9e5dac64d31d80e6e9432fe2c500d0bba2c01
Authorizations
APIKeyHeaderAPIKeyHeader
Body
application/json
Response
Successful Response
This is base response model for all responses in partner service.
Was this page helpful?