Skip to main content
GET
/
v2
/
videos
/
{video_id}
Get Video
curl --request GET \
  --url https://tavusapi.com/v2/videos/{video_id} \
  --header 'x-api-key: <api-key>'
{
  "video_id": "",
  "video_name": "<string>",
  "status": "ready",
  "data": {
    "script": "<string>"
  },
  "download_url": "<string>",
  "stream_url": "<string>",
  "hosted_url": "<string>",
  "status_details": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "still_image_thumbnail_url": "<string>",
  "gif_thumbnail_url": "<string>"
}

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.

For AI agents, use https://docs.tavus.io/openapi.yaml for the full HTTP API contract.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
video_id
string
required

A unique identifier for the video.

Query Parameters

​
verbose
boolean

If set to true, the response will include additional video data such as the thumbnail image and gif links.

Response

OK

​
video_id
string

A unique identifier for the video.

Example:

""

​
video_name
string

The name of the video.

​
status
string

Lifecycle status; possible values: queued, generating, ready, deleted, error. When ready, download_url, stream_url, and hosted_url are populated for download, stream, and viewing respectively.

Example:

"ready"

​
data
object
​
download_url
string

A direct link to download your generated video (populated when status is ready).

​
stream_url
string

A direct link to stream your generated video (populated when status is ready).

​
hosted_url
string

A direct link to view your generated video, hosted by Tavus (populated when status is ready).

​
status_details
string

A detailed status of the video.

​
created_at
string

The date and time the video was created.

​
updated_at
string

The date and time of when the video was last updated.

​
still_image_thumbnail_url
string

Included if the verbose query parameter is set to true. A link to an image thumbnail of the video.

​
gif_thumbnail_url
string

Included if the verbose query parameter is set to true. A link to a gif thumbnail of the video.