v2

latestOpenAPI 3.1.02026-08-0810576180.4 KB

InstaStatsVideos

Get Video Status

Get the upload/processing status of a video.

Pass the job_id returned by the submit endpoint. While the endpoint is not yet generally available, a preview state is returned.

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). Unknown metadata is represented by null component scores.

get/api/v1/instastats_videos/{job_id}/status

Path parameters

job_idstring required

Headers

x-api-keystring nullable

Leaguestring nullable

Response

Successful Response

job_idstring required

statestring required

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.

processing_started_atstring nullable

UTC (+00:00) timestamp when the worker started processing; null until processing has started.

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.