Contact details

Contacts Information

curl --request POST \
  --url https://api.explorium.ai/v1/prospects/contacts_information/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "prospect_id": "<string>",
  "request_context": null,
  "parameters": {}
}
'

import requests

url = "https://api.explorium.ai/v1/prospects/contacts_information/enrich"

payload = {
    "prospect_id": "<string>",
    "request_context": None,
    "parameters": {}
}
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_id: '<string>', request_context: null, parameters: {}})
};

fetch('https://api.explorium.ai/v1/prospects/contacts_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/v1/prospects/contacts_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_id' => '<string>',
    'request_context' => null,
    'parameters' => [
        
    ]
  ]),
  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/enrich"

	payload := strings.NewReader("{\n  \"prospect_id\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\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/enrich")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prospect_id\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v1/prospects/contacts_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_id\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}"

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

{
  "response_context": {
    "correlation_id": "<string>",
    "time_took_in_seconds": 123
  },
  "data": {
    "emails": [
      {}
    ],
    "professions_email": "jsmith@example.com",
    "phone_numbers": [
      {}
    ],
    "mobile_phone": "<string>"
  },
  "entity_id": "<string>"
}

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

POST

prospects

contacts_information

enrich

Contacts Information

curl --request POST \
  --url https://api.explorium.ai/v1/prospects/contacts_information/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "prospect_id": "<string>",
  "request_context": null,
  "parameters": {}
}
'

import requests

url = "https://api.explorium.ai/v1/prospects/contacts_information/enrich"

payload = {
    "prospect_id": "<string>",
    "request_context": None,
    "parameters": {}
}
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_id: '<string>', request_context: null, parameters: {}})
};

fetch('https://api.explorium.ai/v1/prospects/contacts_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/v1/prospects/contacts_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_id' => '<string>',
    'request_context' => null,
    'parameters' => [
        
    ]
  ]),
  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/enrich"

	payload := strings.NewReader("{\n  \"prospect_id\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\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/enrich")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prospect_id\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v1/prospects/contacts_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_id\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}"

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

{
  "response_context": {
    "correlation_id": "<string>",
    "time_took_in_seconds": 123
  },
  "data": {
    "emails": [
      {}
    ],
    "professions_email": "jsmith@example.com",
    "phone_numbers": [
      {}
    ],
    "mobile_phone": "<string>"
  },
  "entity_id": "<string>"
}

{
  "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/contacts_information/enrich`

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

string

required

The prospect_id to enrich.

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

request_context

Request Context · object | null

Example:

null

parameters

Parameters · object | null

Response

Successful Response

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

response_context

ResponseContext · object

required

Show child attributes

data

ContactsInformationOutputSchema · object

ContactsInformationOutputSchema · object
ContactsInformationOutputSchema · object[]

Show child attributes

entity_id

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

Overview Individual’s social media presence

⌘I

Explorium AgentSource

Partners

Introduction

Endpoint: `POST /prospects/contacts_information/enrich`

Body Params - Try Me Example

Authorizations

Body

Response

​Introduction

​Endpoint: POST /prospects/contacts_information/enrich

​Body Params - Try Me Example

Authorizations

Body

Response

Introduction

Endpoint: `POST /prospects/contacts_information/enrich`

Body Params - Try Me Example