---
title: "List Videos"
method: GET
path: "/v2/videos"
tags: ["Videos"]
---

# List Videos

`GET /v2/videos`

This endpoint returns a list of all Videos created by the account associated with the API Key in use.

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

- object
  - `data` object[] — Videos for the current page; use `total_count` for the full count under the applied filters.
    - `video_id` string — A unique identifier for the video.
    - `video_name` string — A name for the video.
    - `status` string — The status of the video. Possible values: queued, generating, ready, deleted, error.
    - `data` object
      - `script` string — The script that was initially used to generate the video.
    - `download_url` string — A link to download the video.
    - `hosted_url` string — A link to view the video.
    - `stream_url` string — A link to stream the video.
    - `status_details` string — A detailed status of the video.
    - `background_url` string — A link to a website. This will be used as the background for the video. The website must be publicly accessible and properly formed.
    - `background_source_url` string — A direct link to a video that is publicly accessible via a storage location such as an S3 bucket. This will be used as the background for the video. The video must be publicly accessible.
    - `still_image_thumbnail_url` string — A link to a still image that is a thumbnail of the video.
    - `gif_thumbnail_url` string — A link to a gif that is a thumbnail of the video.
    - `error_details` string — If the video has an error, this will contain the error message.
  - `total_count` integer — The total number of videos given the filters provided.

## Other responses

- `401` — UNAUTHORIZED

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)