---
title: "Get a job"
method: GET
path: "/v1/jobs/{id}"
tags: ["Jobs"]
---

# Get a job

`GET /v1/jobs/{id}`

## Request

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

## Path parameters

- `id` string, required: The job id from POST /v1/jobs.

## Response `200`

The job, with its result once it has succeeded.

- Job
  - `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.
- `404`: No such job.

---

[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)