Voices

List Voices

Changed on Nov 3, 2026

Lists your Voice resources.

Send source. It selects which voices to return and is what makes this endpoint return Voice resources at all:

GET /v2/voices?source=user     # voices you created
GET /v2/voices?source=system   # the Tavus catalog
GET /v2/voices?source=all      # both

<Note> Omitting `source` returns a legacy stock-voice listing instead: `voice_name` slugs and their linked face metadata, with `page` and `limit` echoed in the response. It carries no `voice_id` values and cannot see voices you created. </Note>

get/v2/voices

Request

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

Query parameters

source'user' | 'system' | 'all'

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

limitinteger

Page size (1–100).

pageinteger

Page number (1-based).

sort'asc' | 'desc'

Sort by name, ascending or descending.

searchstring

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

tagstring

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

Response

total_countinteger

Total voices matching the filters, before pagination.

Example response

{
  "data": [
    {
      "voice_id": "v0a1b2c3d4e5f",
      "voice_name": "Ana",
      "description": "Warm, unhurried, mid-Atlantic",
      "voice_type": "user",
      "status": "completed",
      "tags": [
        "support",
        "en"
      ],
      "created_at": "2026-08-17T12:00:00.000000"
    }
  ],
  "total_count": 12
}

Changes

Nov 3, 2026932c24e63be2 Revision changes
- breaking
  the /// response's property type changed from object to string for status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the new optional query request parameter source
- info
  added the non-success response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history