Introduction - Outhire

The Outhire public API provides RESTful endpoints for integrating your recruiting workflows with external systems.

Base URL

https://app.outhire.ai/api/v1

All endpoints require a Bearer token in the Authorization header. See Authentication for details on creating and managing API keys.

curl https://app.outhire.ai/api/v1/jobs \
  -H "Authorization: Bearer outh_your_api_key_here"

Method	Endpoint	Description
`GET`	`/api/v1/jobs`	List all jobs
`GET`	`/api/v1/jobs/:id`	Get a specific job

Method	Endpoint	Description
`GET`	`/api/v1/candidates`	List candidates
`POST`	`/api/v1/candidates`	Create a candidate (JSON or multipart with resume)
`GET`	`/api/v1/candidates/:id`	Get a specific candidate
`PATCH`	`/api/v1/candidates/:id`	Update a candidate
`GET`	`/api/v1/candidates/:id/notes`	List candidate notes
`POST`	`/api/v1/candidates/:id/notes`	Add a note to a candidate

All responses return JSON. Errors use a consistent envelope:

{
  "error": {
    "code": "not_found",
    "message": "Resource not found."
  }
}

See Authentication for the full list of error codes.