Skip to main content
GET
Get Job Status
Check where a render job is at. This comes back right away, so poll it every 3–5 seconds until the job is complete or failed. Once it’s done, grab the finished video from cdn_url.
This endpoint does not require authentication. You can poll job status without an API key.
Job status and cdn_url are available for 1 hour after job creation. After that, the job data expires from the status endpoint. Download or save the cdn_url promptly.

Response fields

Key fields in the response:
current_stage and current_stage_started_at are the recommended way to show live progress — they’re always populated once a stage starts, unlike checkpoint which lags one stage behind.

Polling examples

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

job_id
string
required

Response

Job status

job_id
string
Example:

"job_abc123xyz"

status
enum<string>
Available options:
queued,
processing,
complete,
failed,
cancelled
mode
string | null

The render mode used (e.g. full_pipeline, preprocessed)

checkpoint
string | null

Last completed processing stage within the pipeline

current_stage
enum<string> | null

Pipeline stage the worker is currently running. Only set while status is processing.

Available options:
ref,
dri,
bg,
render
current_stage_started_at
string<date-time> | null

ISO 8601 timestamp when current_stage started

progress_pct
number | null

Estimated progress percentage (0-100)

Example:

60

cdn_url
string<uri> | null

CDN URL to download the final video (available when status is complete)

mask_cdn_url
string<uri> | null

CDN URL for the alpha/mask video (transparent mode only). White = character, black = background. Use with cdn_url for compositing.

error
string | null

Short error label when status is failed

error_code
string | null

Structured error code (e.g. CS-UORC01-002) when status is failed

error_message
string | null

Human-readable error description when status is failed

progress
object | null

v1 compat progress object

download_url
string<uri> | null

Mirrors cdn_url when complete

chunks
object[]

Always an empty array in v2. Retained for backward compatibility.

created_at
string<date-time> | null

Timestamp when the job was created

completed_at
string<date-time> | null

Timestamp when the job completed