Contact information

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": "<string>",
  "request_context": null,
  "parameters": {
    "contact_types": []
  }
}
'

import requests

url = "https://api.explorium.ai/v2/prospects/contact_information/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/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' => '<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/v2/prospects/contact_information/enrich"

	payload := strings.NewReader("{\n  \"prospect_ids\": \"<string>\",\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/v2/prospects/contact_information/enrich")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prospect_ids\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {\n    \"contact_types\": []\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\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {\n    \"contact_types\": []\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "response_context": {
    "correlation_id": "<string>",
    "time_took_in_seconds": 123
  },
  "data": [
    {
      "prospect_id": "<string>",
      "data": {
        "emails": [
          {}
        ],
        "professional_email": "<string>",
        "phone_numbers": [
          {}
        ],
        "mobile_phone": "<string>"
      }
    }
  ],
  "total_results": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

POST

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": "<string>",
  "request_context": null,
  "parameters": {
    "contact_types": []
  }
}
'

import requests

url = "https://api.explorium.ai/v2/prospects/contact_information/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/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' => '<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/v2/prospects/contact_information/enrich"

	payload := strings.NewReader("{\n  \"prospect_ids\": \"<string>\",\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/v2/prospects/contact_information/enrich")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prospect_ids\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {\n    \"contact_types\": []\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\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {\n    \"contact_types\": []\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "response_context": {
    "correlation_id": "<string>",
    "time_took_in_seconds": 123
  },
  "data": [
    {
      "prospect_id": "<string>",
      "data": {
        "emails": [
          {}
        ],
        "professional_email": "<string>",
        "phone_numbers": [
          {}
        ],
        "mobile_phone": "<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.
Retrieve multiple email addresses, including personal and professional.
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.

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

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 contact details, emails, and phone numbers.

Request Schema

Field	Type	Description
`prospect_id`	String	A unique identifier for the prospect (Required)

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

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
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

Body Params - Try Me Example

prospect_id: ee936e451b50c70e068e1b54e106cb89173198c4

Email Only (2 credits):

  {
    "prospect_id": "ee936e451b50c70e068e1b54e106cb89173198c4",
    "parameters": {
      "contact_types": ["email"]
    }
  }

Phone Only (5 credits):

{
    "prospect_id": "ee936e451b50c70e068e1b54e106cb89173198c4",
    "parameters": {
      "contact_types": ["phone"]
    }
  }

Both Email and Phone (5 credits) - Default behavior:

{
    "prospect_id": "ee936e451b50c70e068e1b54e106cb89173198c4",
    "parameters": {
      "contact_types": ["email", "phone"]
    }
  }

Backward Compatible (no parameters = all contact types):

prospect_id: ee936e451b50c70e068e1b54e106cb89173198c4

Authorizations

api_key

string

header

required

Body

application/json

prospect_ids

required

Pattern: ^[a-f0-9]{40}$

request_context

Request Context · object | null

Example:

null

parameters

ContactsEnrichmentParams · object

Show child attributes

Response

Successful Response

This is base response model for all responses in partner service.

response_context

ResponseContext · object

required

Show child attributes

data

V2ProspectEnrichRow[V2ContactsInformationOutputSchema] · object[]

required

Show child attributes

total_results

integer

required

⌘I

Getting started

Businesses

Business enrichments

Prospects

Prospect enrichments

Research (GenAI)

Async jobs

Autocomplete

Credits

Events & Webhooks

Introduction

Endpoint: `POST /prospects/contact_information/enrich`

Body Params - Try Me Example

Authorizations

Body

Response

​Introduction

​Endpoint: POST /prospects/contact_information/enrich

​Body Params - Try Me Example

Authorizations

Body

Response

Introduction

Endpoint: `POST /prospects/contact_information/enrich`

Body Params - Try Me Example