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

​
Base URL

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

​
Authentication

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"

​
Available endpoints

​
Jobs

MethodEndpointDescription
GET/api/v1/jobsList all jobs
GET/api/v1/jobs/:idGet a specific job

​
Candidates

MethodEndpointDescription
GET/api/v1/candidatesList candidates
POST/api/v1/candidatesCreate a candidate (JSON or multipart with resume)
GET/api/v1/candidates/:idGet a specific candidate
PATCH/api/v1/candidates/:idUpdate a candidate
GET/api/v1/candidates/:id/notesList candidate notes
POST/api/v1/candidates/:id/notesAdd a note to a candidate

​
Response format

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.