---
title: "List Jobs"
method: GET
path: "/api/v1/jobs"
tags: ["public-api"]
---

# List Jobs

`GET /api/v1/jobs`

## Request

- Base URL: `https://ndi-api.nace.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://ndi-api.nace.ai/api/v1/jobs`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/nace/apis/ndi-service/docs/api/v1/jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

List the tenant's jobs, newest first (summaries only — no result payloads).

## Query parameters

- `limit` integer: Jobs per page.
- `cursor` string, uuid, nullable: ``next_cursor`` from the previous page; omit for the newest page.
- `status` string, nullable: Optional status filter.

## Response `200`

Successful Response

- JobList: Response for ``GET /jobs``: newest first, cursor-paginated.
  - `jobs` JobSummary[]
    - `job_id` string, uuid, required
    - `action` string, required
    - `status` string, required
    - `error` JobError
      - `code` string, required: Stable machine-readable error code.
      - `message` string, required: Human-readable failure detail.
    - `is_example` boolean: True for provisioned Playground example jobs.
    - `created_at` string, date-time, required
    - `completed_at` string, date-time, nullable
    - `credits_used` integer, nullable: Credits charged to this job per the ledger. 0 for failed/cancelled jobs (never charged) and zero-credit example jobs; null while the job is non-terminal (not counted yet) or for a succeeded job predating the ledger.
  - `next_cursor` string, nullable: Pass as ``cursor`` to fetch the next (older) page; null when exhausted.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `413`: Request Entity Too Large
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/nace/apis/ndi-service.md) - [All operations](https://skmtc.dev/nace/apis/ndi-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nace/apis/ndi-service/revisions/d9d1f8ec2207?raw)