Skip to main content
GET
List Voices
Read only
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.
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 Details. 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 TTS provider

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

Accent of the voice

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

Gender of the voice

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

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

Voices returned successfully.

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