Biz-KYC Decision Chain API
Retrieve the decision chain (directors and key officers) of a Biz-KYC company, page by page.
ENDPOINTS
POST /api/v1/company/biz/decisionChain
Request parameters
orgId
string
Company identifier returned by the Biz-KYC Company Search API
- Required:
Yes - Example:
5a1b2c3d4e5f000000000001
page
integer
Page number. Each page holds up to 20 records
- Required:
No - Example:
1
updateData
boolean
Bypass locally stored data and pull the latest records from the upstream source
- Required:
No - Example:
false
Request Example
{
"orgId": "5a1b2c3d4e5f000000000001",
"page": 1,
"updateData": false
}
curl https://api.tradedata.io/api/v1/company/biz/decisionChain \
-H "Authorization: Bearer yourTokenHere" \
-H "Content-Type: application/json" \
-d '{"orgId": "5a1b2c3d4e5f000000000001", "page": 1, "updateData": false}'
import requests
response = requests.post(
"https://api.tradedata.io/api/v1/company/biz/decisionChain",
headers={
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
json={
"orgId": "5a1b2c3d4e5f000000000001",
"page": 1,
"updateData": False,
},
)
print(response.json())
const response = await fetch("https://api.tradedata.io/api/v1/company/biz/decisionChain", {
method: "POST",
headers: {
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
body: JSON.stringify({
"orgId": "5a1b2c3d4e5f000000000001",
"page": 1,
"updateData": false
}),
});
const data = await response.json();
<?php
$ch = curl_init("https://api.tradedata.io/api/v1/company/biz/decisionChain");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer yourTokenHere",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"orgId" => "5a1b2c3d4e5f000000000001",
"page" => 1,
"updateData" => false
]),
]);
echo curl_exec($ch);
Response parameters
code
int
Status code
- Example:
200
data
array
Result container
data.fullName
string
Full name of the person
- Example:
John Doe
data.position
string
Job title or role in the company
- Example:
Director
data.updateTime
string
Timestamp of the last update of this record
- Example:
2026-06-01T08:30:00
total
int
Total number of records available for this company
- Example:
36
pageSize
int
Records per page, fixed at 20
- Example:
20
Response Example
{
"code": 200,
"success": true,
"data": [
{
"fullName": "John Doe",
"position": "Director",
"updateTime": "2026-06-01T08:30:00"
},
{
"fullName": "Jane Smith",
"position": "Chief Executive Officer",
"updateTime": "2026-06-01T08:30:00"
}
],
"total": 36,
"pageSize": 20,
"msg": "OK"
}
An empty data array is returned when orgId is missing or no decision chain record exists for the company.