Skip to main content
GET
/
v2
/
videos
List Videos
curl --request GET \
  --url https://tavusapi.com/v2/videos \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "video_id": "783537ef5",
      "video_name": "My First Video",
      "status": "generating",
      "data": {
        "script": "Hello from Tavus! Enjoy your new replica"
      },
      "download_url": "",
      "hosted_url": "<string>",
      "stream_url": "",
      "status_details": "",
      "background_url": "",
      "background_source_url": "",
      "still_image_thumbnail_url": "",
      "gif_thumbnail_url": "",
      "error_details": ""
    }
  ],
  "total_count": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.tavus.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
limit
integer

The number of videos to return per page. Default is 10.

​
page
integer

The page number to return (0-indexed). Default is 0 (first page).

Response

​
data
object[]

Videos for the current page; use total_count for the full count under the applied filters.

​
total_count
integer

The total number of videos given the filters provided.