> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.confirm.global/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.confirm.global/_mcp/server. # API Reference The CONFIRM API lets you read and manage your organization's candidates, jobs, applications, and background checks from your own systems. > **Note** > > The API is in **Early Access**. Talk to your CONFIRM account team before you build an integration, so we can help you set it up and let you know about changes ahead of time. ## Base URL ``` https://api.confirm.global ``` All endpoints documented here are under the `/api/v1/` prefix. ## Authentication Every request must include a bearer token: ``` Authorization: Bearer ``` Tokens are issued per user session today (the same JWT your CONFIRM login uses). Dedicated API keys are planned for a future release; until then, contact CONFIRM for help obtaining a token for integration use. ## Organization scoping Requests operate within your organization. Your token determines which organization you act as, and you can only read or modify candidates, jobs, applications, and background checks that belong to it. Your user's role also determines which actions are allowed — for example, write endpoints require write permission on the relevant resource. ## Resources | Resource | Description | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Candidates** | People who applied to your jobs: list and search, update contact details, view activity timelines, advance to interview scheduling, send evaluations, and manage the blocklist. | | **Jobs** | Role definitions: create, update, copy, and close jobs, list a job's applications, and manage per-job knowledge base documents. | | **Applications** | A candidate's application to a specific job: read full detail, move through pipeline stages, schedule and reschedule interviews, reject, hire, or withdraw. | | **Background Checks** | Initiate background checks for an application, track their status, and list available check services and pipelines. | ## Example: list candidates ```bash curl "https://api.confirm.global/api/v1/candidates?limit=10&page=1" \ -H "Authorization: Bearer $CONFIRM_TOKEN" ``` A successful response returns a paginated list: ```json { "data": [ { "candidate_id": "6f4a1c2e-...", "first_name": "Jordan", "last_name": "Lee", "email": "jordan@example.com", "phone": "+15555550123", "source": "indeed" } ], "pagination": { "total": 128, "page": 1, "limit": 10, "total_pages": 13 } } ``` ## Errors Errors return a consistent envelope with a machine-readable code and a request ID you can share with support: ```json { "error": { "code": "CANDIDATE_NOT_FOUND", "message": "Candidate not found", "request_id": "3f2b8c1e-9d4a-4b6f-8e2a-1c5d7f9a0b3e" } } ``` Every response also carries the request ID in an `X-Request-ID` header. To trace a request through your own logs, send your own `X-Request-ID` header and CONFIRM will use that value instead of generating one. > Programmatic access to candidates, jobs, applications, and background checks. ## API Docs - API Reference > Candidates [List candidates](https://docs.confirm.global/api-reference/candidates/list-candidates.md) - API Reference > Candidates [List blocklist entries](https://docs.confirm.global/api-reference/candidates/list-blocklist-entries.md) - API Reference > Candidates [Add a blocklist entry](https://docs.confirm.global/api-reference/candidates/add-blocklist-entry.md) - API Reference > Candidates [Remove a blocklist entry](https://docs.confirm.global/api-reference/candidates/remove-blocklist-entry.md) - API Reference > Candidates [Get a candidate](https://docs.confirm.global/api-reference/candidates/get-candidate.md) - API Reference > Candidates [Update candidate contact information](https://docs.confirm.global/api-reference/candidates/update-candidate.md) - API Reference > Candidates [Get a candidate's activity timeline](https://docs.confirm.global/api-reference/candidates/get-candidate-timeline.md) - API Reference > Candidates [Advance a candidate to interview scheduling](https://docs.confirm.global/api-reference/candidates/advance-candidate.md) - API Reference > Candidates [Send an evaluation link](https://docs.confirm.global/api-reference/candidates/send-candidate-evaluation.md) - API Reference > Jobs [List jobs](https://docs.confirm.global/api-reference/jobs/list-jobs.md) - API Reference > Jobs [Create a job](https://docs.confirm.global/api-reference/jobs/create-job.md) - API Reference > Jobs [Get a job](https://docs.confirm.global/api-reference/jobs/get-job.md) - API Reference > Jobs [Delete a job](https://docs.confirm.global/api-reference/jobs/delete-job.md) - API Reference > Jobs [Update a job](https://docs.confirm.global/api-reference/jobs/update-job.md) - API Reference > Jobs [Copy a job](https://docs.confirm.global/api-reference/jobs/copy-job.md) - API Reference > Jobs [List applications for a job](https://docs.confirm.global/api-reference/jobs/list-job-applications.md) - API Reference > Jobs [List knowledge base documents for a job](https://docs.confirm.global/api-reference/jobs/list-job-knowledge-base-documents.md) - API Reference > Jobs [Upload a knowledge base document](https://docs.confirm.global/api-reference/jobs/upload-job-knowledge-base-document.md) - API Reference > Jobs [Delete a knowledge base document](https://docs.confirm.global/api-reference/jobs/delete-job-knowledge-base-document.md) - API Reference > Applications [Get an application](https://docs.confirm.global/api-reference/applications/get-application.md) - API Reference > Applications [Update an application](https://docs.confirm.global/api-reference/applications/update-application.md) - API Reference > Applications [Move an application forward](https://docs.confirm.global/api-reference/applications/move-application-forward.md) - API Reference > Applications [Reject an application](https://docs.confirm.global/api-reference/applications/reject-application.md) - API Reference > Applications [Hire a candidate](https://docs.confirm.global/api-reference/applications/hire-application.md) - API Reference > Applications [Schedule an interview](https://docs.confirm.global/api-reference/applications/schedule-application-interview.md) - API Reference > Applications [Reschedule an interview](https://docs.confirm.global/api-reference/applications/reschedule-application-interview.md) - API Reference > Applications [Change pipeline stage](https://docs.confirm.global/api-reference/applications/change-application-stage.md) - API Reference > Applications [Withdraw an application](https://docs.confirm.global/api-reference/applications/withdraw-application.md) - API Reference > Applications [Get available stage transitions](https://docs.confirm.global/api-reference/applications/get-available-stages.md) - API Reference > Applications [Get stage history](https://docs.confirm.global/api-reference/applications/get-application-stage-history.md) - API Reference > Applications [List notes](https://docs.confirm.global/api-reference/applications/list-application-notes.md) - API Reference > Background Checks [Initiate a background check](https://docs.confirm.global/api-reference/background-checks/initiate-background-check.md) - API Reference > Background Checks [List background check pipelines](https://docs.confirm.global/api-reference/background-checks/list-background-check-pipelines.md) - API Reference > Background Checks [List available check services](https://docs.confirm.global/api-reference/background-checks/list-background-check-services.md) - API Reference > Background Checks [Get a background check](https://docs.confirm.global/api-reference/background-checks/get-background-check.md) - API Reference > Background Checks [Submit a background check after consent](https://docs.confirm.global/api-reference/background-checks/submit-background-check.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://docs.confirm.global/api-reference/openapi.json) - [OpenAPI YAML](https://docs.confirm.global/api-reference/openapi.yaml)