Voices
List Voices
deprecated
Browse every text-to-speech voice on the platform, filterable by language and gender, for use when configuring agents.
GET
Get all voices with optional filtering and pagination
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.
Query parameters
Errors
401 Unauthorizedis returned when the API key is missing or revoked.
Related endpoints
- Get Voice: detail for a single voice.
- List Voice Models: model variants for a voice.
- List Accents: accent filter dimension.
- Text-to-speech and voices: guidance on choosing the right voice.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Filter by provider name
Available options:
elevenlabs, smallestai, sarvam, cartesia Filter by accent
Available options:
indian, british, american, canadian, african, australian, swedish Filter by gender
Available options:
male, female, non-binary Search by voice name
Example:
"English"
Page number (starts from 1)
Example:
"1"
Number of records per page (default: 20, max: 50)
Example:
"20"
Filter voices that support a specific language ID
Example:
"abc12345678901"
Filter voices compatible with a specific LLM ID (S2S models only)
Example:
"abc12345678901"
Get all voices with optional filtering and pagination