---
title: "Get Job Status"
method: GET
path: "/api/v0/job-statuses/{job_status_id}"
tags: ["Job Status"]
---

# Get Job Status

`GET /api/v0/job-statuses/{job_status_id}`

## Path parameters

- `job_status_id` string, uuid, required

## Response `200`

Successful Response

- JobStatusGetResponse
  - `id` string, uuid, required — The ID of the job status.
  - `status` string, required — The status of the job. Options: `queued`, `processing`, `done`, `error`, `cancelled`.
  - `error_message` string, nullable, required — The error message returned from the job, if any.
  - `created_at` string, date-time, required — The date and time the job status was created.
  - `worker_active` boolean, nullable — Whether a worker is currently executing a per-page task for this job. None when the job has no per-page dispatch (e.g. single-task jobs) or has reached a terminal state. Allows clients to distinguish 'queued behind another job' from 'actively being processed' when status='processing' — the orchestrator flips status to 'processing' before fan-out, so the field alone is ambiguous on a single-worker stack.
  - `tasks_completed` integer, nullable — Number of per-page tasks that have reported completion for this job. None when the job has no per-page dispatch (e.g. single-task jobs) or has reached a terminal state. Pair with tasks_total to render fraction progress (e.g. '3 / 11 pages').
  - `tasks_total` integer, nullable — Total number of per-page tasks this job dispatched. None when the job has no per-page dispatch or has reached a terminal state.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) · [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outerport/outerport-api/revisions/f565b46daaea/schema)