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

# List Jobs

`GET /v1/switchx/generations`

List your SwitchX jobs with cursor-based pagination.

## Query parameters

- `limit` integer — Number of items per page
- `page_token` string, nullable — Pagination token

## Response `200`

Successful Response

- SwitchXListResponse — Paginated list of SwitchX jobs.
  - `jobs` SwitchXStatusResponse[]
    - `id` string, required — Job identifier (swx_...)
    - `status` string, required — in_queue, processing, completed, or failed
    - `progress` integer, nullable — Progress percentage (0-100)
    - `generation_type` string, nullable — 'image' or 'video'
    - `alpha_mode` string, nullable — 'auto', 'fill', 'custom', or 'select'
    - `output` SwitchXOutputUrls — Signed URLs for SwitchX job outputs.
      - `render` string, nullable — Composited output URL
      - `source` string, nullable — Preprocessed source URL
      - `alpha` string, nullable — Alpha matte URL
    - `seed` integer, nullable — Random seed used for this generation (always present after job creation)
    - `error` string, nullable — Error message (present when status is failed)
    - `created_at` string, nullable — ISO 8601 timestamp when the job was created
    - `modified_at` string, nullable — ISO 8601 timestamp of the last status change
    - `completed_at` string, nullable — ISO 8601 timestamp when the job completed or failed
    - `webhook` WebhookStatus — Webhook delivery status for a generation job.
      - `status` string, nullable — 'pending', 'delivered', or 'failed'
      - `attempts` integer, nullable — Number of delivery attempts so far
      - `last_error` string, nullable — Error message from the last failed delivery attempt
  - `next_page_token` string, nullable — Pass as page_token to fetch the next page. Null when no more results.

---

[API](https://skmtc.dev/beeble/apis/beeble-developer-api.md) · [All operations](https://skmtc.dev/beeble/apis/beeble-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beeble/beeble-developer-api/revisions/f35ce0de5d00/schema)