---
title: List jobs
description: Your workspace's jobs, newest first.
---
`GET` `/v1/jobs`

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

Returns jobs newest first, one page at a time. Pass `next_cursor` back as `starting_after` for the next page. Find a job you lost track of by its `idempotency_key`.

## Request

### Headers

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

### Query

| Name | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | No | 1–100 jobs per page. |
| `status` | string | No | `queued`, `processing`, `completed`, `failed` or `canceled`. |
| `type` | string | No | A job type, such as `image_generation` or `video_generation`. |
| `starting_after` | string | No | The `next_cursor` from the previous page. |

## Example

<!-- api-call-example:v2-jobs-list -->

## Response

`200 OK`

```json
{
  "data": {
    "jobs": [
      "…job objects, newest first…"
    ],
    "next_cursor": "MjAyNi0xMC0xNFQyMzowMToxNC4yNDBafGpvYl9iZmNhYTNhNS1mMWQwLTQ0NWQtOTIxOC0wNDNjYmE4MDAyNGQ"
  }
}
```

## Errors

| Status | `code` | When |
|---|---|---|
| 400 | `invalid_request` | A query value is out of range. |
| 401 | `unauthorized` | No key, or the key is wrong or revoked. |
| 429 | `rate_limited` | Too many requests for your key in this window. |

[All error codes](/docs/errors)

## Related

- [Get a job](/docs/reference/jobs/get)
- [Idempotency](/docs/idempotency)