Skip to main content
GET
/
v1
/
switchx
/
generations
/
{job_id}
Get Job Status
curl --request GET \
  --url https://api.beeble.ai/v1/switchx/generations/{job_id} \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "status": "<string>",
  "progress": 72,
  "generation_type": "<string>",
  "alpha_mode": "<string>",
  "output": {
    "render": "<string>",
    "source": "<string>",
    "alpha": "<string>"
  },
  "seed": 123,
  "error": "<string>",
  "created_at": "<string>",
  "modified_at": "<string>",
  "completed_at": "<string>",
  "webhook": {
    "status": "<string>",
    "attempts": 1,
    "last_error": "<string>"
  }
}

Authorizations

​
x-api-key
string
header
required

Your Developer API key.

Path Parameters

​
job_id
string
required

Response

200 - application/json

Successful Response

Status response for a SwitchX job.

​
id
string
required

Job identifier (swx_...)

​
status
string
required

in_queue, processing, completed, or failed

​
progress
integer | null

Progress percentage (0-100)

Example:

72

​
generation_type
string | null

'image' or 'video'

​
alpha_mode
string | null

'auto', 'fill', 'custom', or 'select'

​
output
SwitchXOutputUrls · object

Output URLs (present when status is completed). URLs are signed and expire after 72 hours. Each call to this endpoint generates fresh signed URLs, so you can always re-fetch if a URL has expired.

​
seed
integer | null

Random seed used for this generation (always present after job creation)

​
error
string | null

Error message (present when status is failed)

​
created_at
string | null

ISO 8601 timestamp when the job was created

​
modified_at
string | null

ISO 8601 timestamp of the last status change

​
completed_at
string | null

ISO 8601 timestamp when the job completed or failed

​
webhook
WebhookStatus · object

Webhook delivery status (present only when a callback_url was provided)