---
title: "List shorts requests"
method: GET
path: "/videos/{videoId}/shorts"
tags: ["Shorts"]
---

# List shorts requests

`GET /videos/{videoId}/shorts`

## Request

- Base URL: `https://api.braiv.co/v1`
- URL: `https://api.braiv.co/v1/videos/{videoId}/shorts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Lists lightweight request projections for a video. Required scope: `videos:read`.

## Path parameters

- `videoId` string, required

## Response `200`

Shorts requests for the video.

- ShortsList
  - `requests` ShortsListItem[], required: Shorts requests associated with the video.
    - `id` string, required: Shorts request ID.
    - `status` 'pending' | 'queued' | 'processing' | 'complete' | 'partial_failed' | 'failed', required: Shorts request lifecycle: `pending` and `queued` are waiting to run, `processing` is generating outputs, `complete` produced all planned outputs, `partial_failed` produced at least one usable output, and `failed` produced no usable result. Complete and partial failure responses use HTTP 200; a terminal failure uses HTTP 422.
    - `outputType` 'shorts' | 'promo' | 'clips', required: Generated output family.
    - `jobId` string, required: Pollable shorts job ID.

## Other responses

- `401`: A supported authentication header is missing or contains an invalid Public API key.
- `403`: Authentication succeeded, but the required scope, workspace role, or resource permission is missing.
- `404`: The resource does not exist or is not accessible to the caller.
- `429`: The API key exceeded its allowed concurrency or request rate. Retry after in-flight work completes or the limit resets.
- `500`: An unexpected server error occurred.

---

[API](https://skmtc.dev/braiv/apis/braiv-public-api.md) - [All operations](https://skmtc.dev/braiv/apis/braiv-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/braiv/apis/braiv-public-api/revisions/8ed0fd0d0a6f?raw)