> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paraform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Paraform API

> Call Paraform from your own systems. Endpoints are grouped by the persona that can call them.

Send every request to `https://external-api.paraform.com/api/external/v1` with a bearer token:

```bash theme={null}
curl "https://external-api.paraform.com/api/external/v1/identity" \
  -H "Authorization: Bearer pf_live_…"
```

Endpoints are grouped by persona. A token only reaches its own persona's endpoints, and each endpoint page lists the scopes it requires. Call `GET /identity` to check which persona and scopes your token has.

| Persona | Token | APIs |
| - | - | - |
| Agency | Agency API key, created by an agency owner on the [**API Keys**](https://www.paraform.com/agency/api-keys) tab of the agency settings | Agency roles, Talent Network |
| Recruiter | Personal API key, created on the [**API keys**](https://www.paraform.com/manage/api-keys) tab of your account settings | Roles, candidates, recommendations, Parascribe calls |

For access, email [team@paraform.com](mailto:team@paraform.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.