Jobs

Retrieve a single job

Poll an async render, video, upload, or photo mockup creation job. Returns its current status and result when available.

get/api/v1/jobs/{job_id}

Request

  • Base URL: https://api.sudomock.com
  • URL: https://api.sudomock.com/api/v1/jobs/{job_id}
  • Auth: API key in header x-api-key

Path parameters

job_idstring required

Id returned when this job was accepted.

Response

Successful Response

job_idstring required

Identifier of this job.

kindstring required

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

status'queued' | 'dispatched' | 'running' | 'succeeded' | 'failed' | 'cancelled' required

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

result_urlstring nullable

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

mockup_uuidstring nullable

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

credits_chargedinteger nullable

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

created_atstring required

When this job was submitted.

updated_atstring required

When this job last changed.

modelstring nullable

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

outcome_tierstring nullable

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

Example response

{
  "created_at": "2026-09-18T10:24:31.482913+00:00",
  "credits_charged": 38,
  "job_id": "5f1c0b2a-7d43-4e9a-8c16-0b5d3f7a2e94",
  "kind": "video",
  "model": "veo-3.1-fast",
  "outcome_tier": "standard",
  "result_url": "https://cdn.sudomock.com/mockup-assets/videos/5f1c0b2a/clip.mp4",
  "status": "succeeded",
  "updated_at": "2026-09-18T10:41:07.118204+00:00",
  "error": null,
  "mockup_uuid": null,
  "payg": null,
  "watermark": null
}

Changes

No recorded changes to this operation across all 1 revision of this API.