Skip to main content
GET

Authorizations

x-api-key
string
header
required

API key with sm_ prefix. Get your key at https://sudomock.com/dashboard/api-keys

Path Parameters

job_id
string
required

Id returned when this job was accepted.

Response

200 - application/json

Successful Response

Where a job stands right now, and its result once it has finished.

job_id
string
required

Identifier of this job.

Example:

"5f1c0b2a-7d43-4e9a-8c16-0b5d3f7a2e94"

kind
string
required

What this job does: render, video, upload, 2d_create, 2d_render, photo_mockup_create or photo_mockup_render.

Example:

"video"

status
enum<string>
required

Where the job stands, and it is over once this reads succeeded, failed or cancelled.

Available options:
queued,
dispatched,
running,
succeeded,
failed,
cancelled
created_at
string
required

When this job was submitted.

Example:

"2026-09-18T10:24:31.482913+00:00"

updated_at
string
required

When this job last changed.

Example:

"2026-09-18T10:41:07.118204+00:00"

result_url
string | null

Link to the finished file, or the path of the mockup that was created, and null until the job succeeds.

Example:

"https://cdn.sudomock.com/mockup-assets/videos/5f1c0b2a/clip.mp4"

mockup_uuid
string | null

Identifier of the mockup this job created, and null for jobs that hand back a file instead.

error
JobError · object | null

Why the job produced no result, and null unless it failed or was cancelled.

credits_charged
integer | null

Credits you actually paid for this job, which is zero once a failed or cancelled job has been refunded.

Example:

38

payg
JobPaygCost · object | null

Pay as you go cost of this job, and null when it was paid for with plan or extra credits.

watermark
JobWatermark · object | null

Why this result is marked and how to get unmarked results, and null when the result is clean.

model
string | null

The video model that produced this clip, present on video jobs only.

outcome_tier
string | null

The quality level this clip was produced at, present on video jobs only.

Example:

"standard"