API reference · Jobs
List recent jobs, newest first
GET /api/v1/jobs
Cursor-paginated. Pass the returned next_before as before to get the next page; it is null on the last page. Rate limit: 120 requests per minute.
Authenticate with your key in the X-API-Key header — Authentication.
Query parameters
- limit integer default: 50
Maximum jobs to return.
- before string
Cursor from a previous page's
next_before.
Responses
- 200 A page of jobs.
- 400 The request was understood but cannot be acted on — for example, completing an upload whose bytes never arrived.
- 401 Missing, malformed or revoked API key.
- 429 Too many requests for this endpoint. Back off and retry; the official SDKs do this for you.
200 response fields
- jobs object[] required
- next_before string | null
Cursor for the next page, or null on the last page.
Related endpoints
- Retrieve one job GET /api/v1/jobs/{job_id}
- Server-sent progress events for a job GET /api/v1/jobs/{job_id}/stream
- Cancel a job POST /api/v1/jobs/cancel
- Check many jobs for failure in one call POST /api/v1/jobs/check-failed