Business Contact People Detail API
Retrieve full profile for a single person by person ID.
ENDPOINTS
POST /api/v1/businessContact/people/detail
Request parameters
person_id
string
Person ID.
- Required:
Yes - Example:
5a1b2c3d4e5f000000000002
Request Example
{
"person_id": "5a1b2c3d4e5f000000000002"
}
curl https://api.tradedata.io/api/v1/businessContact/people/detail \
-H "Authorization: Bearer yourTokenHere" \
-H "Content-Type: application/json" \
-d '{"person_id": "5a1b2c3d4e5f000000000002"}'
import requests
response = requests.post(
"https://api.tradedata.io/api/v1/businessContact/people/detail",
headers={
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
json={
"person_id": "5a1b2c3d4e5f000000000002",
},
)
print(response.json())
const response = await fetch("https://api.tradedata.io/api/v1/businessContact/people/detail", {
method: "POST",
headers: {
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
body: JSON.stringify({
"person_id": "5a1b2c3d4e5f000000000002"
}),
});
const data = await response.json();
<?php
$ch = curl_init("https://api.tradedata.io/api/v1/businessContact/people/detail");
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" => "5a1b2c3d4e5f000000000002"
]),
]);
echo curl_exec($ch);
Response parameters
data.id
string
Person ID.
- Example:
5a1b2c3d4e5f000000000002
data.name
string
Full name.
- Example:
John Doe
data.first_name
string
First name.
- Example:
John
data.last_name
string
Last name.
- Example:
Doe
data.title
string
Current job title.
- Example:
Senior Software Engineer
data.headline
string
Profile headline.
- Example:
e at Ford Motor Company
data.seniority
string
Seniority level. Values: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern.
- Example:
entry
data.email
string
Email address.
- Example:
[email protected]
data.email_status
string
Email verification status. Values: verified, suspicious, unavailable.
- Example:
verified
data.country
string
Country.
- Example:
Vietnam
data.city
string
City.
data.state
string
State or region.
data.linkedin_url
string
LinkedIn profile URL.
- Example:
https://www.linkedin.com/in/example-profile
data.photo_url
string
Profile photo URL.
data.organization_id
string
Current organization ID.
- Example:
5b1b2c3d4e5f000000000004
data.organization.id
string
Organization ID.
- Example:
5b1b2c3d4e5f000000000004
data.organization.name
string
Organization name.
- Example:
Ford Motor Company
data.organization.industry
string
Organization industry.
- Example:
automotive
data.organization.website_url
string
Organization website.
- Example:
http://www.ford.com
data.organization.estimated_num_employees
integer
Estimated employee count.
- Example:
171000
data.organization.primary_domain
string
Primary domain.
- Example:
ford.com
data.employment_history.current
boolean
Whether this is the current role.
- Example:
true
data.employment_history.organization_id
string
Organization ID.
- Example:
5b1b2c3d4e5f000000000004
data.employment_history.organization_name
string
Organization name.
- Example:
Ford Motor Company
data.employment_history.title
string
Job title at this role.
- Example:
e
data.employment_history.start_date
string
Start date in YYYY-MM-DD format.
- Example:
2016-03-01
Response Example
{
"code": 200,
"success": true,
"data": {
"country": "Vietnam",
"last_name": "Doe",
"first_name": "John",
"title": "e",
"email_status": "verified",
"organization_id": "5b1b2c3d4e5f000000000004",
"organization": {
"name": "Ford Motor Company",
"id": "5b1b2c3d4e5f000000000004",
"industry": "automotive",
"website_url": "http://www.ford.com",
"estimated_num_employees": 171000,
"primary_domain": "ford.com"
},
"name": "John Doe",
"id": "5a1b2c3d4e5f000000000002",
"photo_url": "https://example.com/photo.jpg",
"employment_history": [
{
"current": true,
"organization_id": "5b1b2c3d4e5f000000000004",
"organization_name": "Ford Motor Company",
"title": "e",
"start_date": "2016-03-01"
}
],
"linkedin_url": "https://www.linkedin.com/in/example-profile",
"headline": "e at Ford Motor Company",
"email": "[email protected]",
"seniority": "entry"
},
"msg": "success",
"total": 0,
"pageSize": 0,
"current": 0,
"sumResult": null
}