# User API — Team & Business

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](https://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](/content/guide/article/api-user-freemium/index.html).

## 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.

```bash
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).

```bash
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).

```bash
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.

```bash
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").

```bash
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.

```bash
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.

```bash
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.

```bash
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.

```bash
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.

```bash
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.

```bash
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.

```bash
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.

```bash
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"}'
```