---
title: "Retrieve a single job"
method: GET
path: "/api/v1/jobs/{job_id}"
tags: ["Jobs"]
---

# Retrieve a single job

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

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

## Path parameters

- `job_id` string, required: Id returned when this job was accepted.

## Response `200`

Successful Response

- JobStatusResponse: Where a job stands right now, and its result once it has finished.
  - `job_id` string, required: Identifier of this job.
  - `kind` string, 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_url` string, nullable: Link to the finished file, or the path of the mockup that was created, and null until the job succeeds.
  - `mockup_uuid` string, nullable: Identifier of the mockup this job created, and null for jobs that hand back a file instead.
  - `error` JobError: Why a job produced no result.
    - `error_code` string, required: Stable code for this failure, safe to branch on in your own code.
    - `message` string, required: Plain language explanation of what went wrong.
  - `credits_charged` integer, nullable: Credits you actually paid for this job, which is zero once a failed or cancelled job has been refunded.
  - `payg` JobPaygCost: What this job costs at the account's pay as you go rate.
    - `credits` integer, nullable: Credits this job bills.
    - `unit_price` number, nullable: Price of one credit in US dollars for this account.
    - `cost` number, nullable: Total US dollars for this job, the credits multiplied by the unit price.
  - `watermark` JobWatermark: Why the result carries a watermark, and where to get results without one.
    - `reason` string, required: Why this result was marked.
    - `remove_url` string, required: Where to go to start getting unmarked results.
  - `created_at` string, required: When this job was submitted.
  - `updated_at` string, required: When this job last changed.
  - `model` string, nullable: The video model that produced this clip, present on video jobs only.
  - `outcome_tier` string, nullable: The quality level this clip was produced at, present on video jobs only.

---

[API](https://skmtc.dev/sudomock/apis/sudomock-api.md) · [All operations](https://skmtc.dev/sudomock/apis/sudomock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sudomock/apis/sudomock-api/revisions/c1cc24006c60?raw)