---
title: "Get shorts outputs"
method: GET
path: "/shorts/{shortsRequestId}"
tags: ["Shorts"]
---

# Get shorts outputs

`GET /shorts/{shortsRequestId}`

## Request

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

Returns up to five non-deleted outputs. `partial_failed` returns 200 because usable outputs may be present. Required scope: `videos:read`.

## Path parameters

- `shortsRequestId` string, required

## Response `200`

Request completed fully or partially; inspect `status` and `outputs`.

- Shorts
  - `shortsRequestId` 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.
  - `clipsExpected` integer: Planned number of outputs.
  - `jobId` string, required: Pollable shorts job ID.
  - `outputs` ShortsOutput[], required: All available non-deleted generated outputs for the request.
    - `outputId` string, required: Generated output ID.
    - `type` 'shorts' | 'promo' | 'clips': Output family.
    - `videoUrl` string, uri: Playback URL for the generated video.
    - `thumbnailUrl` string, uri: Generated output thumbnail URL.
    - `duration` number: Output duration in seconds.
    - `title` string: Generated output title.
    - `description` string: Generated output summary.

## Other responses

- `202`: Request is pending or processing; outputs may be incomplete.
- `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.
- `422`: Request failed with no successful terminal result.
- `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)