Skip to main content
GET
List Voices
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

source
enum<string>

Which voices to return. Send this to get Voice resources; omit it only for the legacy stock-voice listing.

Available options:
user,
system,
all
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
sort
enum<string>
default:asc

Sort by name, ascending or descending.

Available options:
asc,
desc

Legacy stock-voice listing only, ignored when source is set. Case-insensitive substring match on voice_name.

tag
string

Legacy stock-voice listing only, ignored when source is set. Returns only voices whose face tags include this tag name (case-insensitive).

Response

data
object[]

Voices for the current page.

total_count
integer

Total voices matching the filters, before pagination.

Example:

12