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
}

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. Default is 1.

Response

200
application/json

The response is of type object.