---
title: "List User Jobs"
method: GET
path: "/api/jobs"
---

# List User Jobs

`GET /api/jobs`

## Request

- Base URL: `https://api.kdpcoloringbook.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kdpcoloringbook.com/api/jobs`
- Auth: HTTP bearer

## Query parameters

- `skip` integer
- `limit` integer

## Response `200`

Successful Response

- JobListResponse
  - `jobs` JobStatusPayload[], required
    - `job_id` string, required
    - `status` string, required
    - `progress` number, required
    - `theme` string, required
    - `title` string, required
    - `pages` integer, required
    - `selected_style` string, required
    - `images` ImageStatus[], required
      - `slot` integer, required
      - `status` string, required
      - `prompt` string, nullable
      - `simple_prompt` string, nullable
      - `simple_prompt_es` string, nullable
      - `url` string, nullable
      - `creative_brief` string, nullable
      - `simple_creative_brief` string, nullable
      - `simple_creative_brief_es` string, nullable
      - `bw_image_path` string, nullable
      - `error` string, nullable
      - `retries` integer
      - `bw_image_prompt` string, nullable
      - `bw_image_model` string, nullable
      - `completed_at` string, nullable
      - `framed` boolean
      - `page_type` string
    - `created_at` string, required
    - `user_id` string, nullable
    - `watermarked` boolean
    - `brand_signature` string, nullable
    - `language` string
    - `is_shared` boolean
    - `amazon_url` string, nullable
    - `shared_page_slots` integer[], nullable
    - `cover` CoverSummary
      - `cover_id` string, required
      - `status` string, required
      - `title` string, required
      - `preview_url` string, nullable
      - `front_url` string, nullable
      - `error_message` string, nullable
      - `generation_elapsed_seconds` number, nullable
      - `estimated_generation_seconds` number, nullable
      - `estimate_sample_count` integer
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kdpcoloringbook/apis/book-generator-api.md) · [All operations](https://skmtc.dev/kdpcoloringbook/apis/book-generator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kdpcoloringbook/apis/book-generator-api/revisions/f330c566ffc2?raw)