---
title: "Get Video"
method: GET
path: "/v2/videos/{video_id}"
tags: ["Videos"]
---

# Get Video

`GET /v2/videos/{video_id}`

This endpoint returns a single video by its unique identifier.

## Path parameters

- `video_id` string, required

## Query parameters

- `verbose` boolean

## Response `200`

OK

- object
  - `video_id` string — A unique identifier for the video.
  - `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.
  - `data` object
    - `script` string — The script that was initially used to generate the video.
  - `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.

## Other responses

- `400` — Bad Request
- `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)