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

# One job

`GET /jobs/{id}`

## Request

- Base URL: `https://pagefully.com/api/v1`
- URL: `https://pagefully.com/api/v1/jobs/{id}`
- Auth: HTTP bearer

Poll every two seconds or so until `state` is `done` or `failed`.

## Path parameters

- `id` string, uuid, required

## Response `200`

The job.

- object
  - `job` Job, required
    - `id` string, uuid, required
    - `type` string, required
    - `state` 'queued' | 'running' | 'done' | 'failed', required
    - `app_id` string, uuid, nullable, required
    - `page_id` string, uuid: For a job about one page.
    - `steps` object[], required
      - `key` string, required
      - `label` string, required
      - `state` 'pending' | 'running' | 'done' | 'failed', required
    - `progress` object, required
      - `done` integer, required
      - `total` integer, required
    - `result` object, nullable, required: Once done: counts, and the ids of jobs it started (for example brief_job_id, build_job_id).
    - `error` object, nullable, required
      - `code` string, required
      - `message` string, required
    - `created_at` string, required
    - `finished_at` string, nullable, required

## Other responses

- `401`: No token, or one that is not valid or has been revoked.
- `404`: Not found on this workspace.
- `429`: Too many calls: 120 requests a minute for a token, and 20 generation starts an hour. `retry_after` is seconds.

---

[API](https://skmtc.dev/pagefully/apis/pagefully-api.md) · [All operations](https://skmtc.dev/pagefully/apis/pagefully-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pagefully/apis/pagefully-api/revisions/60e17ce09d31?raw)