Business Contact Enrich API
Unlock and retrieve email for a specific contact.
ENDPOINTS
POST /api/v1/businessContact/contact/enrich
Request parameters
person_id
string
Person ID
- Required:
Yes - Example:
5a1b2c3d4e5f000000000001
Request Example
{
"person_id": "5a1b2c3d4e5f000000000001"
}
curl https://api.tradedata.io/api/v1/businessContact/contact/enrich \
-H "Authorization: Bearer yourTokenHere" \
-H "Content-Type: application/json" \
-d '{"person_id": "5a1b2c3d4e5f000000000001"}'
import requests
response = requests.post(
"https://api.tradedata.io/api/v1/businessContact/contact/enrich",
headers={
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
json={
"person_id": "5a1b2c3d4e5f000000000001",
},
)
print(response.json())
const response = await fetch("https://api.tradedata.io/api/v1/businessContact/contact/enrich", {
method: "POST",
headers: {
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
body: JSON.stringify({
"person_id": "5a1b2c3d4e5f000000000001"
}),
});
const data = await response.json();
<?php
$ch = curl_init("https://api.tradedata.io/api/v1/businessContact/contact/enrich");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer yourTokenHere",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"person_id" => "5a1b2c3d4e5f000000000001"
]),
]);
echo curl_exec($ch);
Response parameters
data.email
string
Unlocked email address
- Example:
[email protected]
data.emailStatus
string
Email verification status
- Example:
verified
data.emailConfidence
number
Email confidence score
data.primaryPhone
string
Primary phone number
- Example:
+1 555-000-0000
data.personalPhone
string
Personal phone (populated after phone unlock)
data.personalPhoneWebhook
integer
Personal phone webhook status
- Example:
0
data.updateTime
string
Last update timestamp
- Example:
2026-06-26 14:59:08
Response Example
{
"code": 200,
"success": true,
"data": {
"primaryPhone": "+1 555-000-0000",
"emailStatus": "verified",
"personalPhone": "",
"emailConfidence": null,
"updateTime": "2026-06-26 14:59:08",
"personalPhoneWebhook": 0,
"email": "[email protected]"
},
"msg": "OK",
"total": 0,
"pageSize": 0,
"current": 0,
"sumResult": null
}