GET /v1/jobs/:id

Read the status of any job your account owns. Used to poll ?async=true submissions and to fetch a fresh presigned downloadUrl for old jobs.

Request

GET /v1/jobs/f5012a57-9bd7-47b9-9eaf-6f9c00356872 HTTP/1.1
Authorization: Bearer img_live_...

Response

{
  "jobId": "f5012a57-9bd7-47b9-9eaf-6f9c00356872",
  "status": "completed",
  "inputBytes": 32947,
  "outputBytes": 8465,
  "ratio": 0.74,
  "error": null,
  "downloadUrl": "https://storage.pixozip.pretzl.dev/.../?X-Amz-..."
}

status is one of queued, active, completed, failed.

For failed, error carries the worker's failure message. No token is charged for failed jobs.

Listing recent jobs

GET /v1/jobs?limit=25&before=2026-05-24T00:00:00Z HTTP/1.1
Authorization: Bearer <jwt>

Paginated cursor by created_at. Up to 100 per request. Uses the dashboard JWT, not the API key.