---
title: "Get Video Status"
method: GET
path: "/api/v1/videos/{video_uuid}/status"
tags: ["Videos"]
---

# Get Video Status

`GET /api/v1/videos/{video_uuid}/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.

## Path parameters

- `video_uuid` string, required

## Headers

- `x-api-key` string, nullable
- `League` string, nullable

## Response `200`

Successful Response

- VideoStatusResponse — Response schema for video processing status check.
  - `video_id` string, required — The ID of the video
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required — Enum for video processing status.
  - `progress` integer, nullable — Processing progress percentage (0-100)
  - `message` string, nullable — Status message or error details
  - `info_required` boolean — True when the submission was accepted (credit charged) but the game info has not been provided yet — processing starts only after POST /videos/{video_uuid}/info.
  - `created_at` string, date-time, required — Timestamp of submission
  - `updated_at` string, date-time, required — Timestamp of last update
  - `completed_at` string, date-time, nullable — Timestamp when processing completed

## Other responses

- `422` — Validation Error

---

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