Get Voice
Voices
Get Voice
Returns a single voice and its current status.
GET
Get Voice
For AI agents, use
https://docs.tavus.io/openapi.yaml for the full HTTP API contract.Authorizations
Path Parameters
The voice identifier, e.g. v0a1b2c3d4e5f.
Response
A Tavus Voice. Reference it by voice_id; Tavus picks the provider that is the best fit for the language(s) of the conversation.
Stable identifier. Use as layers.tts.voice_id on a PAL, or default_voice_id on a face.
Example:
"v0a1b2c3d4e5f"
Example:
"Ana"
Example:
"Warm, unhurried, mid-Atlantic"
user for voices you created, system for the Tavus catalog.
Available options:
user, system Example:
"user"
started while the voice is still being created, completed once it is ready to use, error if creation failed (see error_message).
Available options:
started, completed, error Example:
"completed"
Present only when status is error.
Example:
Example:
"2026-08-17T12:00:00.000000"

