API reference
HireHappy API
A REST API over your organization's hiring: jobs and their pipelines, candidates, applications, AI scorecards and interviews. Every endpoint, with what it takes and returns, and a request in cURL, Python and Node.js.
Base URL
https://api.hirehappy.io/v1- Authentication
Authorization: Bearer hh_sk_…, with a key made under Settings → API keys- Format
- JSON in and out, UTF-8; times in ISO 8601, in UTC
- Lists
limit(up to 100) andoffset, with thetotal- Errors
- One shape for all: a
typeto branch on, amsgto show
OpenAPI 3.1, for generating a client, importing into Postman or Insomnia, or handing to an AI tool.
curl https://api.hirehappy.io/v1/organizations/self \
-H "Authorization: Bearer $HIREHAPPY_API_KEY"{
"id": "0b6f3c2e-8a41-4d7e-9c55-3e2f1a7b9d10",
"name": "Acme",
"slug": "acme",
"website": "https://acme.com",
"timezone": "Europe/Berlin"
}Resources
Your jobs: posting them on the job board, closing them, and their details
The people you're considering, one per person across all your jobs, with their resumes
The hiring team's notes on candidates
A candidate's candidacy for one job: its stage, status and AI score
Applications scored by AI against their job's rubric, with the evidence
Interviews, calls and assessments of applications