Videos

Get Video Status

Get the processing status of a submitted video.

When VIDEO_ENDPOINTS_LIVE is False, returns a preview response without DB access. Requires League header and x-api-key header.

get/api/v1/videos/{video_uuid}/status

Path parameters

video_uuidstring 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

video_idstring required

Partner-supplied video UUID echoed from the request path

status'pending' | 'processing' | 'completed' | 'failed' required

Enum for video processing status.

progressinteger nullable

Processing progress percentage (0-100)

messagestring nullable

Status message or error details

info_requiredboolean

True when the submission was accepted (credit reserved) but the game info has not been provided yet — processing starts only after POST /videos/{video_uuid}/info.

created_atstring date-time required

Timestamp of submission

updated_atstring date-time required

Timestamp of last update

completed_atstring date-time nullable

Timestamp when processing completed

Changes

Changed in 1 of the 10 revisions of this API.42

Aug 27, 20269b0abde08b0642See the full diff
- ▲
  the header request parameter League became required
  request-parameter-became-required
- ▲
  the header request parameter x-api-key became required
  request-parameter-became-required
- ▲
  header request parameter League list-of-types was narrowed by removing types null
  request-parameter-list-of-types-narrowed
- ▲
  header request parameter x-api-key list-of-types was narrowed by removing types null
  request-parameter-list-of-types-narrowed
- ○
  for the header request parameter League, the type/format was generalized from / to string/
  request-parameter-type-generalized
- ○
  for the header request parameter x-api-key, the type/format was generalized from / to string/
  request-parameter-type-generalized

Full history