---
title: "List Video Detected Clips"
method: GET
path: "/api/v1/videos/{video_uuid}/clips"
tags: ["Videos"]
---

# List Video Detected Clips

`GET /api/v1/videos/{video_uuid}/clips`

Detected play clips for a submitted video — the same data the internal
flow serves at /jobs/{job_id}/clips.

video_uuid accepts either the Glory League video UUID or the league DB's
numeric videos.video_id (the /jobs key).

Empty until the stats were delivered (the clips query itself filters on
league status '4'). 404 when the key matches nothing.

When VIDEO_ENDPOINTS_LIVE is False, returns a preview response.

## Path parameters

- `video_uuid` 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

- DetectedClipsResponse
  - `clips` DetectedClip[], required
    - `video_id` string, required
    - `jersey_number` string, nullable
    - `team` string, nullable
    - `play_type` string, nullable
    - `play_type_name` string, nullable
    - `video_start_time` string, nullable
    - `video_end_time` string, nullable
    - `video_link` string, nullable
    - `exact_timestamp` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **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

[Change history](https://skmtc.dev/preciser/apis/preciser-data-management-api/changes/api/v1/videos/:video_uuid/clips/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/9b0abde08b06/schema)