API reference / Get a job

Get a job

Poll until status is done or error. Poll about once every 2 seconds. Files are private and use the same session or API key as the job.

GET/api/jobs/{id}
Authenticate with X-API-Key. Keep your key on your server; never embed it in a public website.

Response

200 · Success
{
  "id": "image_id",
  "name": "photo.jpg",
  "status": "done",
  "quality": "fast",
  "credits": 1,
  "created": 1789052400,
  "expires": 1789056000,
  "original_url": "/api/files/image_id/original.png",
  "width": 1200,
  "height": 800,
  "result_url": "/api/files/image_id/cutout.png",
  "mask_url": "/api/files/image_id/mask.png"
}

Errors use a structured error.code and error.message. See error handling →

Clearcut support