---
title: "Get a background job"
method: GET
path: "/v3/background-jobs/{jobId}"
tags: ["Background Jobs"]
---

# Get a background job

`GET /v3/background-jobs/{jobId}`

<small>_Requires the `other:read` scope (or a broader one that includes it)._</small>

Returns the full record for a background job, including raw input (`jsonData`) and result (`jsonDataResult`) JSON payloads when available.

## Path parameters

- `jobId` string, uuid, required

## Response `200`

Background job record

- object — A long-running background operation tracked by the API. Includes status, progress, timing, and the raw input/result JSON payloads.
  - `jobId` string, uuid — Unique identifier for the background job
  - `status` 'Scheduled' | 'Processing' | 'Done' | 'Failed' | 'Expired' | 'Cancelled' | 'Unknown' — Current job status. One of `Scheduled`, `Processing`, `Done`, `Failed`, `Expired`, `Cancelled`, or `Unknown` for unrecognized terminal states.
  - `category` string, nullable — Job category, e.g. `r2/bg-jobs/email-validation`. Use the suffix (`email-validation`) when filtering the list endpoint.
  - `startedAt` string, date-time — When the job started
  - `finishedAt` string, date-time, nullable — When the job reached a terminal state, or null if still running
  - `progress` number, double, nullable — Job progress in `[0..1]`. Null if the job hasn't reported progress yet.
  - `jsonData` string, nullable — Raw JSON of the input parameters captured at job creation. Opaque — shape is per-category.
  - `jsonDataResult` string, nullable — Raw JSON of the job result. Populated only when `status` is terminal (`Done` / `Failed`). Opaque — shape is per-category.

## Other responses

- `400` — Invalid job identifier (e.g., empty GUID)
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `404` — Background job not found
- `429` — Too Many Requests
- `503` — Upstream background-jobs service is temporarily unavailable

---

[API](https://skmtc.net/reply/apis/reply-api.md) · [All operations](https://skmtc.net/reply/apis/reply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reply/reply-api/revisions/1c3d32eaf95e/schema)