Skip to main content
GET
Get Job Status

Authorizations

x-api-key
string
header
required

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 | null

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 | null

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