Voices
List Voices
List all voices available for agents.
GET
List Voices
Read only
Returns every text-to-speech voice supported by DialNexa, paginated and filterable by language code or gender. Each entry includes the voice’s stable
Recommended. This endpoint is part of the public
/v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.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 Details: 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 TTS provider
Available options:
elevenlabs, smallestai, sarvam, cartesia Accent of the voice
Available options:
indian, british, american, canadian, african, australian, swedish Gender of the voice
Available options:
male, female, non-binary Search by voice name
Example:
"English"
Page number (starts from 1)
Example:
1
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"
List Voices