Skip to main content
Retrieve the status and, once complete, the result of a generation job. Poll this endpoint until status is done or failed. 
GET /jobs/{job_id}

​
Headers

​
Authorization
string
required
Bearer <YOUR_API_KEY>. See Authentication.

​
Path parameters

​
job_id
string
required
UUID of the job, as returned by a generation request.

​
Response

​
job_id
string
UUID of the job.
​
status
string
One of queued, processing, done, failed. See Jobs & polling.
​
created_at
datetime
When the job was accepted.
​
started_at
datetime | null
When processing began. null while still queued.
​
finished_at
datetime | null
When the job reached a terminal state. null until then.
​
result
object | null
Present only when status is done.
​
error
string | null
Failure reason. Present only when status is failed.
curl -s https://bananahub.io/api/v1/jobs/$JOB_ID \
  -H "Authorization: Bearer $API_KEY"

{
  "job_id": "0193a7f2-1c4a-7e0b-9b3a-2f1d8c6e4a55",
  "status": "done",
  "created_at": "2026-06-11T12:00:00Z",
  "started_at": "2026-06-11T12:00:01Z",
  "finished_at": "2026-06-11T12:00:09Z",
  "result": {
    "image_url": "https://cdn.bananahub.io/results/...?X-Amz-Signature=..."
  },
  "error": null
}
A 404 is returned for an unknown id or a job owned by another account.