Available on Team and Business plans. These endpoints add warm path intelligence on top of the Freemium API. If you're on Team or Business, you have access to both this and the Freemium endpoints. Full reference at app.ctd.ai/account/api-access/documentation?type=user.

This article covers endpoints exclusive to Team and Business plans. For contacts, company lookups, and ghost emails, see the Freemium API article.

Paths

The paths suite is the core of what makes CTD unique — find warm introduction routes to any person or company, through your team's combined network.

GET /user/atc-paths-api/public/v2/paths

Returns warm intro paths to a specific person or company, through your team's collective network.

curl "http://api.ctd.ai/user/atc-paths-api/public/v2/paths?company_domain=acme.com" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"
GET /user/atc-paths-api/public/v2/paths/connector

Returns all paths that run through a specific connector (person in your network).

curl "http://api.ctd.ai/user/atc-paths-api/public/v2/paths/connector?connector_email=jane@example.com" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"
GET /user/atc-paths-api/public/v2/paths/by-stage

Returns paths filtered by their current stage (e.g., intro requested, intro made).

curl "http://api.ctd.ai/user/atc-paths-api/public/v2/paths/by-stage?stage=intro_requested" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"
PATCH /user/atc-paths-api/public/v2/paths/{pathId}/stage

Update the stage of a specific path — useful for syncing path status back from your CRM.

curl -X PATCH "http://api.ctd.ai/user/atc-paths-api/public/v2/paths/PATH_ID/stage" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com" \
  -H "Content-Type: application/json" \
  -d '{"stage": "intro_made"}'
GET /user/atc-paths-api/public/v1/paths/search

Search paths using natural language (e.g., "find paths to CFOs at Series B fintech companies").

curl "http://api.ctd.ai/user/atc-paths-api/public/v1/paths/search?q=CFO+at+fintech+company" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"

Reachable people & companies

GET /user/atc-paths-api/public/v1/reachable-person

Returns reachability data for a specific person — whether they can be reached through your network and how.

curl "http://api.ctd.ai/user/atc-paths-api/public/v1/reachable-person?email=jane@acme.com" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"
GET /user/atc-paths-api/public/v1/reachable-people

Returns a list of people reachable through your network, with path summaries.

curl "http://api.ctd.ai/user/atc-paths-api/public/v1/reachable-people" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"
GET /user/atc-paths-api/public/v1/company

Returns reachability data for a specific company — how many employees are reachable and through whom.

curl "http://api.ctd.ai/user/atc-paths-api/public/v1/company?domain=acme.com" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"
GET /user/atc-paths-api/public/v1/reachable-companies

Returns all companies reachable through your network.

curl "http://api.ctd.ai/user/atc-paths-api/public/v1/reachable-companies" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"
GET /user/atc-paths-api/public/v1/people

Returns reachable employees at a specific company.

curl "http://api.ctd.ai/user/atc-paths-api/public/v1/people?domain=acme.com" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"

Job changes (enriched)

GET /user/atc-paths-api/public/v1/job-changes

Returns job changes across your target accounts and tracked contacts — richer than the Freemium job changes endpoint.

curl "http://api.ctd.ai/user/atc-paths-api/public/v1/job-changes" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"

Activities

GET /user/asks-api/public/v1/activities

Returns a log of ghost email and outreach activity across your workspace.

curl "http://api.ctd.ai/user/asks-api/public/v1/activities" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com"

Approvers

POST /user/enterprise/api/v1/public/approvers

Returns the outreach approvers configured for a specific connector — used before creating a ghost email to know who needs to approve it.

curl -X POST "http://api.ctd.ai/user/enterprise/api/v1/public/approvers" \
  -H "ctd-api-key: YOUR_API_KEY" \
  -H "ctd-client-id: you@yourcompany.com" \
  -H "Content-Type: application/json" \
  -d '{"connector_email": "jane@example.com"}'