---
title: "Paginated list of Videos"
method: GET
path: "/videos"
---

# Paginated list of Videos

`GET /videos`

Returns a paginated array of Videos

## Query parameters

- `page` integer
- `limit` integer
- `nameSearchQuery` string
- `avatarId` string
- `voiceId` string
- `extrasFilter` string

## Response `200`

A paginated list of Videos

- object
  - `totalItems` integer — Total number of videos available
  - `totalPages` integer — Total number of pages
  - `currentPage` integer — Current page number
  - `itemsPerPage` integer — Number of items per page
  - `videos` Video[]
    - `id` string, uuid
    - `name` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `status` string — Can be either `IDLE`, `GENERATING_AUDIO`, `GENERATING_VIDEO`, `DONE` or `FAILED`.
    - `moments` object[] — An array of Moment items, each representing a portion of the complete video.
      - `transcript` string — A portion of the complete transcript. Current limit: 250 characters.
      - `avatarId` string — The id of the avatar to be used for this moment.
      - `voiceId` string — The id of the voice to be used for this moment.
      - `audioUrl` string — The audio that will be used for the video rendering. Automatically generated from the transcript when not provided. Current limit: 20 seconds.
      - `videoUrl` string — The url of the avatar rendering video for this moment.
      - `gestureSlug` string — The slug identifier of the gesture to be used for this moment.
    - `videoUrl` string — The url of the final avatar rendering video, containing all the moments merged.
    - `videoUrlSubtitled` string — The url of the final avatar rendering video with subtitles. Only available if subtitles are enabled.
    - `subtitles` object — Subtitles settings for the video
      - `enable` boolean
    - `extras` object — A dictionary of custom key-value pairs to extend the video metadata. Maximum of 5 key-value pairs of 256 characters allowed.

## Other responses

- `400` — Unexpected error

---

[API](https://skmtc.dev/argildotai/apis/argil-api.md) · [All operations](https://skmtc.dev/argildotai/apis/argil-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/argildotai/argil-api/revisions/48a779d9f736/schema)