---
search:
  tags:
    - Jobs
    - GET
seo:
  description: >-
    Returns the job's current status. Poll this about once a second after you
    start the job, and… Reference for the GET /v1/jobs/{id} endpoint in the
    convt API.
sidebar:
  label: Get a job
  badge: GET
title: Get a job
type: openapi-operation
---
Returns the job's current status. Poll this about once a second after you start the job, and stop when `status` is `succeeded`, `failed` or `cancelled`.

Jobs disappear 24 hours after they were created. After that this returns `404 not_found`, whatever state the job was in.

`GET /v1/jobs/{id}`

**Responses**

- `200` — The job.
- `400` — Request refused
- `401` — \`unauthorized\`: no \`Authorization: Bearer\` header.
- `403` — \`unauthorized\` (key invalid or revoked) or a billing limit.
- `404` — \`not\_found\`: the job does not exist, belongs to another account, or has expired.
- `429` — \`rate\_limited\`: more than 120 requests in a minute for this key.
- `502` — \`storage\_unavailable\`: object storage did not answer. Retry with backoff.

Response example, 200:

```json
{
  "id": "job_01k6z7v4q8m3x2a9b5c0d1e2f3",
  "status": "running",
  "input_format": "png",
  "target_format": "webp",
  "input_bytes": 48213,
  "attempt": 1,
  "error_code": null,
  "expires_at": "2026-10-08T12:00:00Z"
}
```