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

# List jobs

> GET /jobs — your job history, newest first

Lists your jobs, newest first, with cursor pagination and an optional status filter. Entries are lightweight summaries — no result payloads; fetch [`GET /jobs/{job_id}`](/api-reference/get-job) for a result. Never rate-limited.

```text theme={"dark"}
GET /jobs
```

## Request

<ParamField query="limit" type="integer" default="50">
  Jobs per page, 1–200.
</ParamField>

<ParamField query="cursor" type="uuid">
  `next_cursor` from the previous page. Omit for the newest page. An unknown
  cursor returns `404`.
</ParamField>

<ParamField query="status" type="string">
  Optional filter: `pending`, `running`, `succeeded`, or `failed`.
</ParamField>

## Response

<ResponseField name="jobs" type="array">
  Summaries: `job_id`, `action`, `status`, `error` (only for failed jobs),
  `created_at`, `completed_at`.
</ResponseField>

<ResponseField name="next_cursor" type="string | null">
  Pass as `cursor` to fetch the next (older) page. `null` when there are no
  more pages.
</ResponseField>

Pagination is cursor-based (not offset-based), so pages stay consistent even while new jobs are being created concurrently.

## Example

```bash theme={"dark"}
curl -s "$NDI_BASE/jobs?limit=2&status=failed" \
  -H "X-API-Key: $NDI_API_KEY"
```

```json theme={"dark"}
{
  "jobs": [
    {
      "job_id": "d4c3b2a1-0f9e-4d8c-b7a6-5e4f3d2c1b0a",
      "action": "ground",
      "status": "failed",
      "error": { "code": "cancelled", "message": "cancelled by client request" },
      "created_at": "2026-07-12T20:58:31Z",
      "completed_at": "2026-07-12T20:59:02Z"
    },
    {
      "job_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "action": "parse",
      "status": "failed",
      "error": { "code": "download_failed", "message": "source returned 403" },
      "created_at": "2026-07-12T19:12:09Z",
      "completed_at": "2026-07-12T19:12:15Z"
    }
  ],
  "next_cursor": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
}
```