---
title: "Get Voice"
method: GET
path: "/v2/voices/{voice_id}"
tags: ["Voices"]
---

# Get Voice

`GET /v2/voices/{voice_id}`

## Request

- Base URL: `https://tavusapi.com`
- URL: `https://tavusapi.com/v2/voices/{voice_id}`
- Auth: API key in header `x-api-key`

Returns a single voice and its current status.

## Path parameters

- `voice_id` string, required

## Response `200`

- Voice: A Tavus Voice. Reference it by `voice_id`; Tavus picks the provider that is the best fit for the language(s) of the conversation.
  - `voice_id` string: Stable identifier. Use as `layers.tts.voice_id` on a PAL, or `default_voice_id` on a face.
  - `voice_name` string
  - `description` string, nullable
  - `voice_type` 'user' | 'system': `user` for voices you created, `system` for the Tavus catalog.
  - `status` 'started' | 'completed' | 'error': `started` while the voice is still being created, `completed` once it is ready to use, `error` if creation failed (see `error_message`).
  - `error_message` string: Present only when `status` is `error`.
  - `tags` string[]
  - `created_at` string, date-time

## Other responses

- `401`: UNAUTHORIZED
- `404`: NOT FOUND

## Changes

- **2026-11-03** `932c24e63be2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/changes/v2/voices/:voice_id/get.md)

---

[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.dev/tavus/apis/tavus-developer-api-collection/revisions/932c24e63be2?raw)