Business Contact Page API

POST /api/v1/businessContact/contact/page

Request parameters

orgId

string

Company organization ID.

• Required: Yes
• Example: 5b1b2c3d4e5f000000000001

domain

string

Company domain. Preferred over orgId when available.

• Required: No
• Example: apple.com

current

integer

Page number.

• Required: Yes
• Example: 1

size

integer

Page size. Maximum: 50.

• Required: Yes
• Example: 25

{
    "orgId": "5b1b2c3d4e5f000000000001",
    "current": 1,
    "size": 25
}

curl https://api.tradedata.io/api/v1/businessContact/contact/page \
  -H "Authorization: Bearer yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{"orgId": "5b1b2c3d4e5f000000000001", "current": 1, "size": 25}'

import requests

response = requests.post(
    "https://api.tradedata.io/api/v1/businessContact/contact/page",
    headers={
        "Authorization": "Bearer yourTokenHere",
        "Content-Type": "application/json",
    },
    json={
        "orgId": "5b1b2c3d4e5f000000000001",
        "current": 1,
        "size": 25,
    },
)
print(response.json())

const response = await fetch("https://api.tradedata.io/api/v1/businessContact/contact/page", {
  method: "POST",
  headers: {
    "Authorization": "Bearer yourTokenHere",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "orgId": "5b1b2c3d4e5f000000000001",
    "current": 1,
    "size": 25
  }),
});
const data = await response.json();

<?php
$ch = curl_init("https://api.tradedata.io/api/v1/businessContact/contact/page");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer yourTokenHere",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "orgId" => "5b1b2c3d4e5f000000000001",
        "current" => 1,
        "size" => 25
    ]),
]);
echo curl_exec($ch);

Response parameters

data.peopleId

string

Person ID.

• Example: 5a1b2c3d4e5f000000000004

data.name

string

Full name.

• Example: Jane Smith

data.firstName

string

First name.

• Example: Jane

data.lastName

string

Last name.

• Example: Gu

data.title

string

Job title.

• Example: PR Director

data.headline

string

Profile headline.

• Example: PR Director @Apple, WSJ, Reuters alum

data.email

string

Email address (empty if locked).

data.emailStatus

string

Email verification status. Values: verified, suspicious, unavailable.

• Example: unavailable

data.emailLocked

boolean

Whether email requires unlocking.

• Example: false

data.phoneLocked

boolean

Whether phone requires unlocking.

• Example: true

data.personalEmailLocked

boolean

Whether personal email requires unlocking.

• Example: false

data.primaryPhone

string

Company/primary phone number.

• Example: +1 555-000-0000

data.personalPhone

string

Personal phone number (empty if locked or not yet unlocked).

data.photoUrl

string

Profile photo URL.

data.linkedinUrl

string

LinkedIn profile URL.

• Example: https://www.linkedin.com/in/example-profile

data.country

string

Country.

• Example: Hong Kong

data.city

string

City.

• Example: Hong Kong

data.domain

string

Company domain.

• Example: apple.com

data.orgId

string

Company organization ID.

• Example: 5b1b2c3d4e5f000000000001

data.sort

integer

Sort order within the page.

• Example: 1

data.personalPhoneStatus

integer

Personal phone unlock status. 0=not requested, 1=pending, 2=completed.

• Example: 0

total

integer

Total matching records.

• Example: 154365

pageSize

integer

Page size.

• Example: 25

current

integer

Current page number.

• Example: 1

{
    "code": 200,
    "success": true,
    "data": [
        {
            "peopleId": "5a1b2c3d4e5f000000000004",
            "firstName": "Jane",
            "lastName": "Gu",
            "name": "Jane Smith",
            "title": "PR Director",
            "headline": "PR Director @Apple, WSJ, Reuters alum",
            "email": "",
            "emailStatus": "unavailable",
            "emailLocked": false,
            "phoneLocked": true,
            "personalEmailLocked": false,
            "personalEmail": "",
            "primaryPhone": "+1 555-000-0000",
            "personalPhone": "",
            "photoUrl": "https://media.licdn.com/...",
            "linkedinUrl": "https://www.linkedin.com/in/example-profile",
            "country": "Hong Kong",
            "city": "Hong Kong",
            "domain": "apple.com",
            "orgId": "5b1b2c3d4e5f000000000001",
            "sort": 1,
            "personalPhoneStatus": 0
        }
    ],
    "msg": "success",
    "total": 154365,
    "pageSize": 25,
    "current": 1,
    "sumResult": null
}