Jobs

Get Job Status By Game

Changed on

Get job status by game_id instead of job_id.

Resolves the scheduled game's linked video and returns its canonical job_id. Existing callers may also continue passing a job_id in this path.

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
  • "failed": processing failed, stopped, or timed out without an automatic retry
  • "partial": processing produced incomplete results
  • "needs_attention": processing acceptance/status requires verification; do not resubmit

processing_started_at is the worker start time in UTC (+00:00).

get/api/v1/jobs/by-game/{game_id}/status

Request

  • Base URL
    https://developer.preciser.io
  • URL
    https://developer.preciser.io/api/v1/jobs/by-game/{game_id}/status
  • Auth
    none declared. Required headers: x-api-key, League

Path parameters

game_idstring required

Headers

x-api-keystring required

Required API key issued by Preciser.

Leaguestring required

Required tenant/database selector, for example pitchbio-master.

Response

Successful Response

sport_game_type'5v5' | '3v3' nullable

Effective basketball format: the per-video override takes precedence over the organization default. 3v3 uses 1/2-point field goals; 5v5 uses 2/3-point field goals. Null when unknown or not applicable.

job_idstring required
statestring required
messagestring nullable

Processing failure, incomplete-result, or verification guidance.

start_of_playstring

Actual game start time from dms_main.videos.actual_game_start_time formatted as a video timestamp; empty until it is available.

completed_atstring nullable

Final worker-start-to-status-complete duration formatted as hh:mm:ss; null until processing is complete, or when worker timing was not recorded.

processing_started_atstring nullable

UTC (+00:00) timestamp when the worker started processing; null until processing has started, or when worker timing was not recorded.

video_qualityobject 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.

Changes