---
title: "Get Job Status"
method: GET
path: "/v1/switchx/generations/{job_id}"
tags: ["switchx"]
---

# Get Job Status

`GET /v1/switchx/generations/{job_id}`

Poll the status of a SwitchX job.

## Path parameters

- `job_id` string, required

## Response `200`

Successful Response

- SwitchXStatusResponse — Status response for a SwitchX job.
  - `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

---

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