---
title: "Get Job Status"
method: GET
path: "/api/v1/jobs/{job_id}/status"
tags: ["Jobs"]
---

# Get Job Status

`GET /api/v1/jobs/{job_id}/status`

Get the status of a processing job.

The returned `state` is one of:
  - "processing": the video is uploaded and still being processed or reviewed
  - "completed": processing finished — stats are available, or there were no clips
  - "Video can not processed by Mux": the source video could not be processed
  - "Jersey Color Mismatch": the home and away jersey colors could not be told apart
  - "Visible Issue": visible quality issue found during QC
  - "cancelled": the job was cancelled by the client

The response also includes `video_quality`: objective measurements of the
source video (resolution and frame_rate) with per-component 0-1 scores.
Unknown metadata is represented by null component scores. No grade or
show/hide decision is implied.

`completed_at` is the final worker-start-to-status-complete duration in
`hh:mm:ss` format. It is `null` until the final status update completes.

`processing_started_at` is the worker start time in UTC (+00:00). It is
`null` until the worker has started.

`issues` contains the customer-visible film issues recorded during review.
Each item includes a stable `issue_type` and `exact_timestamp`. Consumers
map the type to their own display text. It remains empty until completion.

When VIDEO_ENDPOINTS_LIVE is False, returns a preview response.

## Path parameters

- `job_id` string, required

## Headers

- `x-api-key` string, required — Required API key issued by Preciser.
- `League` string, required — Required tenant/database selector, for example pitchbio-master.

## Response `200`

Successful Response

- JobStatusResponse
  - `job_id` string, required
  - `state` string, required
  - `start_of_play` string — Actual game start time from dms_main.videos.actual_game_start_time formatted as a video timestamp; empty until it is available.
  - `completed_at` string, nullable — Final worker-start-to-status-complete duration formatted as hh:mm:ss; null until processing is complete.
  - `processing_started_at` string, nullable — UTC (+00:00) timestamp when the worker started processing; null until processing has started.
  - `video_quality` object, nullable — Objective video-quality measurements (resolution and frame_rate) with per-component 0-1 scores. Unknown metadata is represented by null component scores. No grade or show/hide decision is implied.
  - `issues` JobVideoIssue[] — Customer-visible film issues recorded during review. The list is empty until the job is completed. Consumers should map issue_type to their own display text. Internal notes and analyst identity are never exposed.
    - `issue_type` string, required — Stable machine-readable issue code, for example 'video_cut'. Consumers provide their own display text or localization.
    - `exact_timestamp` string, required — Video timestamp where the issue was observed, formatted as HH:MM:SS to match the /jobs/{job_id}/clips response.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-03** `24ef9111adac` — 1 info
  - added the optional property `issues` to the response with the `200` status
- **2026-08-27** `9b0abde08b06` — 4 breaking, 2 info
  - the `header` request parameter `League` became required
  - the `header` request parameter `x-api-key` became required
  - `header` request parameter `League` list-of-types was narrowed by removing types `null`
  - `header` request parameter `x-api-key` list-of-types was narrowed by removing types `null`
  - …2 more
- **2026-08-08** `42cb7b14430f` — 1 info
  - added the optional property `start_of_play` to the response with the `200` status

[Change history](https://skmtc.dev/preciser/apis/preciser-data-management-api/changes/api/v1/jobs/:job_id/status/get.md)

---

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