Developers

REST API

Read jobs and candidates, and change a candidate's status, with an API key.

Create a key under Integrations (account owners on a paid plan). A key is shown once. It can be read-only or allowed to change status. The API never returns CV text.

curl https://rezumz.com/api/v1/jobs \
  -H "Authorization: Bearer rzk_live_..."

Endpoints

GET   /api/v1/jobs                    ?limit=50&offset=0
GET   /api/v1/jobs/{id}/candidates    ?status=shortlisted&limit=50&offset=0
PATCH /api/v1/candidates/{id}         {"status": "shortlisted"}   (write key)
  • Statuses: new, shortlisted, interview, offer, hold, hired, rejected.
  • limit is 1 to 100 (default 50). Responses look like { data: [...], limit, offset }.
  • Each key may make 120 requests a minute. Beyond that you get 429 with a Retry-After header.
  • Errors return { error } with 401 (missing or invalid key), 403 (read-only key), 404, 429 or 400.
  • Changing a status through the API fires the same webhook event as changing it in the app.

See it on a real hire

Open a private demo with fictional candidates and walk a hire from job description to offer. No sign-up needed.

Try the live demo →