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

# List jobs

`GET /v1/jobs`

## Request

- Base URL: `http://127.0.0.1:7341`
- URL: `http://127.0.0.1:7341/v1/jobs`
- Auth: HTTP bearer

## Response `200`

Jobs from this server process, newest first. Finished jobs are kept for an hour.

- object
  - `jobs` Job[], required
    - `id` string, required
    - `tool` string, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed', required
    - `progress` object, nullable, required: Latest progress from tools that report it (merge, split, pipelines, batches).
      - `progress` number, required
      - `total` number, required
      - `message` string
    - `created_at` string, required: ISO 8601 time.
    - `started_at` string, nullable, required: ISO 8601 time.
    - `finished_at` string, nullable, required: ISO 8601 time.
    - `result` unknown
    - `error` Problem: RFC 9457 Problem Details.
      - `type` string, required: Stable problem type URI: urn:superpdf:problem:<code>.
      - `title` string, required
      - `status` integer, required
      - `detail` string, required: What went wrong and how to fix it.
      - `instance` string, required: URN for this problem occurrence.
      - `code` 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'method_not_allowed' | 'conflict' | 'payload_too_large' | 'unsupported_media_type' | 'validation' | 'operation_failed' | 'too_many_jobs' | 'busy' | 'internal', required
      - `request_id` string, required
      - `errors` object[]: The fields to fix, for validation and conflict problems.
        - `field` string, required
        - `message` string, required
    - `callback` object
      - `url` string, required
      - `status` 'pending' | 'delivering' | 'delivered' | 'failed', required
      - `attempts` integer, required
      - `last_status` integer, nullable, required: HTTP status of the last attempt; null when the receiver could not be reached.

## Other responses

- `401`: The bearer token is missing or wrong.
- `403`: The Host or Origin header is not allowed.

---

[API](https://skmtc.dev/superpdf/apis/superpdf-local-api.md) · [All operations](https://skmtc.dev/superpdf/apis/superpdf-local-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superpdf/apis/superpdf-local-api/revisions/53f71d44b156?raw)