API Overview

Base URL

https://app.jobsbyhumans.com/api/v1

All requests require a Bearer token:

Authorization: Bearer YOUR_API_KEY

All responses are JSON. Errors follow a consistent shape:

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

Code	Meaning
`200`	Success
`400`	Bad request — check your payload
`401`	Unauthorized — invalid API key
`404`	Not found
`422`	Validation error — see `message` for details
`429`	Rate limit exceeded
`500`	Server error — retry with backoff

Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1740657600

For job creation, pass an Idempotency-Key header to safely retry failed requests:

Idempotency-Key: my-unique-batch-2026-02-27

Repeated requests with the same key return the original response without creating a duplicate job.