---
title: "Get video"
method: GET
path: "/videos/{id}"
---

# Get video

`GET /videos/{id}`

## Request

- Base URL: `https://api.shortgenius.com/v1`
- URL: `https://api.shortgenius.com/v1/videos/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required: The unique ID of the video to retrieve.

## Response `200`

Successful response

- Video: Details about the created or retrieved video, including scenes and their media.
  - `id` string, uuid, required
  - `title` string, nullable
  - `caption` string, nullable
  - `created_at` string, required: Date and time (ISO 8601) when the video was created.
  - `updated_at` string, nullable: Date and time (ISO 8601) when the video was last updated.
  - `series_id` string, uuid, required: ID of the associated series.
  - `publishing_state` 'pending' | 'processing' | 'completed' | 'skipped' | 'error', required: Upload status of the video.
  - `publish_at` string, nullable, required: Date and time (ISO 8601) when the video was fully uploaded.

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/shortgenius/apis/shortgenius-api.md) · [All operations](https://skmtc.dev/shortgenius/apis/shortgenius-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shortgenius/apis/shortgenius-api/revisions/532abda8ff32?raw)