Skip to main content
GET
/
jobs
/
{id}
Get Job
curl --request GET \
  --url https://api.supapost.so/jobs/{id}
{
  "id": "0b1e9a5f-1234-4d8c-b2a0-...",
  "type": "image_gen",
  "status": "processing",
  "result": null,
  "error": null,
  "created_at": "2026-04-11T10:00:00Z",
  "updated_at": "2026-04-11T10:00:02Z"
}
Returns the status and (if completed) result of an async job. Use this endpoint to poll jobs created by passing ?async=true to /generate/image or /render.

​
Authentication

​
Authorization
string
Bearer token. Bearer <api-key-or-jwt>.

​
Path Parameters

​
id
string
required
The job ID returned by the ?async=true endpoint.

​
Lifecycle

Jobs progress through these states:
  • pending — queued, not yet picked up by a consumer
  • processing — actively generating
  • completed — finished, result is populated
  • failed — something went wrong, error is populated
Polling: client-side code typically polls every 1–2 seconds until status is completed or failed. 
{
  "id": "0b1e9a5f-1234-4d8c-b2a0-...",
  "type": "image_gen",
  "status": "processing",
  "result": null,
  "error": null,
  "created_at": "2026-04-11T10:00:00Z",
  "updated_at": "2026-04-11T10:00:02Z"
}