Skip to main content
GET
/
v2
/
voices
List Voices
curl --request GET \
  --url https://tavusapi.com/v2/voices \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "voice_name": "anna",
      "replica_id": "r90bbd427f71",
      "audio_url": "<string>",
      "tags": [
        {
          "tag_name": "<string>"
        }
      ]
    }
  ],
  "total_count": 123,
  "page": 123,
  "limit": 123
}

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

Query Parameters

​
limit
integer
default:10

Page size (1–100).

Required range: 1 <= x <= 100
​
page
integer
default:1

Page number (1-based).

Required range: x >= 1
​
search
string

Case-insensitive substring match on voice_name.

​
sort
enum<string>
default:asc

Sort voice_name ascending or descending.

Available options:
asc,
desc
​
tag
string

If set, only voices whose replica tags include this tag name (case-insensitive).

Response

​
data
object[]

Voices for the current page; use total_count, page, and limit with the query parameters for pagination.

​
total_count
integer

Total rows matching filters (before pagination).

​
page
integer
​
limit
integer