---
title: "List videos"
method: GET
path: "/videos"
---

# List videos

`GET /videos`

## Request

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

## Query parameters

- `page` number: The page number to retrieve.
- `limit` number: The maximum number of items per page.

## Response `200`

Successful response

- object
  - `videos` Video[], required: Array of videos.
    - `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.
  - `has_more` boolean, required: Indicates if more items are available.

## 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)