Skip to main content
GET
Get all voices with optional filtering and pagination
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.
Returns every text-to-speech voice supported by DialNexa, paginated and filterable by language code or gender. Each entry includes the voice’s stable id, display name, BCP-47 language_code, perceived gender, and upstream provider. Use the id field as the value for voice.id when creating or updating an agent. The catalogue evolves as upstream providers add new voices, call this endpoint at deploy time rather than hard-coding the list.

When to use this

  • Voice pickers: populate the dropdown when an operator is choosing a voice for an agent.
  • Brand audits: confirm a given voice is still available before publishing an agent change.
  • Localization: find every voice that supports a specific BCP-47 language for a multi-region rollout.
  • Gender-balanced selection: sample voices by gender for accessibility or brand reasons.
For deeper detail on a specific voice (preview URL, default model, supported accents), use Get Voice. For the model variants of a voice, use List Voice Models.

Query parameters

Errors

  • 401 Unauthorized is returned when the API key is missing or revoked.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

provider
enum<string>

Filter by provider name

Available options:
elevenlabs,
smallestai,
sarvam,
cartesia
accent
enum<string>

Filter by accent

Available options:
indian,
british,
american,
canadian,
african,
australian,
swedish
gender
enum<string>

Filter by gender

Available options:
male,
female,
non-binary
name
string

Search by voice name

Example:

"English"

page
number
default:1

Page number (starts from 1)

Example:

"1"

limit
number
default:20

Number of records per page (default: 20, max: 50)

Example:

"20"

language_id
string

Filter voices that support a specific language ID

Example:

"abc12345678901"

llm_id
string

Filter voices compatible with a specific LLM ID (S2S models only)

Example:

"abc12345678901"

Response

Return voices with optional filtering and pagination

voices
object[]
total
number
page
number
limit
number
totalPages
number