> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sutro.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# List jobs

> List Batch jobs, newest first.

## Headers

<ParamField header="Authorization" type="string" required>
  Deployment API key in the form `Key YOUR_SUTRO_API_KEY`.
</ParamField>

<ParamField query="limit" type="integer">
  Page size from 1–100. Omit to return all jobs without pagination.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque `next_cursor` from the previous page. Used only with `limit`; do not modify it.
</ParamField>

```bash theme={null}
curl "https://YOUR-SUTRO-DEPLOYMENT/v1/list-jobs?limit=20" \
  -H "Authorization: Key YOUR_SUTRO_API_KEY"
```

With `limit`, the response is `{ "jobs": [...], "next_cursor": "..." }`; `next_cursor` is `null` after the last page. Without `limit`, it is `{ "message": "...", "jobs": [...] }`. Each entry uses the [job object](/reference/api/fetch-job#response) returned by the single-job endpoint.