---
title: Get job status
description: Where a job is, and what to do next.
---
`GET` `/v1/jobs/{id}/status`

**Host** `https://api.open.sume.com` · **Auth** API key

Returns the job's state, whether it is done, and when to look again. This is the call to poll; see [Polling](/docs/polling). The `x-sume-poll-after` header repeats `next_poll_after_seconds`.

## Request

### Headers

| Header | Type | Required | Description |
|---|---|---|---|
| `Authorization` | string | Yes | `Bearer <key>`. Or send `x-api-key`. |

### Path

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | Yes | The job id (`job_...`) from the submit response. |

## Example

<!-- api-call-example:v2-job-status -->

## Response

`200 OK`

```json
{
  "data": {
    "request_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",
    "job_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",
    "status": "IN_PROGRESS",
    "sume_status": "processing",
    "status_url": "https://api.open.sume.com/v1/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/status",
    "result_url": "https://api.open.sume.com/v1/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/result",
    "cancel_url": null,
    "cancelable": false,
    "next_action": "poll_status",
    "next_poll_after_seconds": 30,
    "recommended_poll_interval_seconds": 2,
    "retry_after_seconds": 30,
    "result_ready": false,
    "terminal": false,
    "queue_position": null
  }
}
```

## Errors

| Status | `code` | When |
|---|---|---|
| 401 | `unauthorized` | No key, or the key is wrong or revoked. |
| 404 | `not_found` | No job with that id in your workspace. |
| 429 | `rate_limited` | Too many requests for your key in this window. |

[All error codes](/docs/errors)

## Related

- [Polling](/docs/polling)
- [Jobs and lifecycle](/docs/jobs)
- [Get a job result](/docs/reference/jobs/result)