---
title: "Get a job"
method: GET
path: "/api/v1/jobs/{id}"
tags: ["Job Management"]
---

# Get a job

`GET /api/v1/jobs/{id}`

## Request

- Base URL: `https://api.imagestep.dev`
- URL: `https://api.imagestep.dev/api/v1/jobs/{id}`
- Auth: API key in header `Authorization`

One job as it stands: its status, the item counts, what ran (op, preset and version, model,
steps) and, per item, the output — `resultAssetId`, or `output` for an `analyze` — or, for a
failed item, `errorCode` and `retryable`. The first 100 items ride inline and `itemsTruncated` says when there are more (`GET /api/v1/jobs/{id}/items`
pages the rest). `actualCredits` is what the job was charged; it is set when the job settles.

**wait** turns the read into a long-poll: the answer is held until the job is terminal or the
window closes, and the job as it stands comes back either way — read `status`. It is how a `202`
from a waited submit is picked up.

A job record lives as long as the assets it made: at `expiresAt` it is swept, and a read after
that is `404`.

USE THIS WHEN:
- Reading what a job produced, or why an item failed
- Waiting for a job to finish without writing a poll loop (`?wait=`)

DO NOT USE WHEN:
- Listing jobs → use GET /api/v1/jobs
- You only want the assets it made → `GET /api/v1/assets?jobId={id}`

## Path parameters

- `id` string, required

## Query parameters

- `wait` integer

## Response `200`

The job — terminal or not; read `status`

## Other responses

- `404`: `job_not_found` — no such job, or it is not yours, or its record has expired
- `429`: Rate limited — `error.code` is `rate_limited` and `retryable` is true. `Retry-After` says how many seconds to wait.
- `503`: `provider_unavailable`, `details.reason` `capacity` — this node holds as many waits as it will; retry after `Retry-After`, or read without `wait`

---

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