> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Voices

> Browse every text-to-speech voice on the platform, filterable by language and gender, for use when configuring agents.

<Warning>
  **Legacy endpoint - deprecated.** Unversioned endpoints are scheduled for removal on **July 31, 2026**. Use the [`/v1` version](/docs/api-reference/v1/voices/list) for new integrations. This endpoint remains available for existing integrations until then.
</Warning>

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](/docs/api-reference/v1/voices/get). For the model variants of a voice, use [List Voice Models](/docs/api-reference/voices/voice-models).

## Query parameters

| Parameter       | Description                                                   |
| --------------- | ------------------------------------------------------------- |
| `language_code` | Filter by BCP-47 language code, for example `en-US`, `hi-IN`. |
| `gender`        | Filter by `male`, `female`, or `neutral`.                     |
| `provider`      | Filter by upstream provider, for example `elevenlabs`.        |
| `page`          | Page number, starting from 1.                                 |
| `limit`         | Results per page (default 50, max 100).                       |

## Errors

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

## Related endpoints

* [Get Voice](/docs/api-reference/v1/voices/get): detail for a single voice.
* [List Voice Models](/docs/api-reference/voices/voice-models): model variants for a voice.
* [List Accents](/docs/api-reference/v1/voices/accents): accent filter dimension.
* [Text-to-speech and voices](/docs/voice-ai/text-to-speech-and-voices): guidance on choosing the right voice.


## OpenAPI

````yaml GET /voices
openapi: 3.0.0
info:
  title: DialNexa API
  description: >-
    Public REST API for the DialNexa voice AI platform. Versioned endpoints are
    under /v1; unversioned endpoints are legacy and deprecated.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: API Keys
  - name: Agent Functions
  - name: Agents V1
  - name: Agents2
  - name: Batch Calls
  - name: Batch Calls V1
  - name: Call Logs
  - name: Calls
  - name: Calls V1
  - name: Campaign Leads
  - name: Campaigns
  - name: External Webhooks
  - name: Knowledge Base
  - name: Knowledge Base V1
  - name: LLMs
  - name: LLMs V1
  - name: Languages
  - name: Languages V1
  - name: Organization Phone Numbers
  - name: Organization Phone Numbers V1
  - name: Phone Number Pricing
  - name: Phone Number Pricing V1
  - name: Transcribers
  - name: Transcribers V1
  - name: User Webhooks
  - name: User Webhooks V1
  - name: V1
  - name: Voices
  - name: Voices V1
  - name: Webcall
  - name: Workflow Leads
  - name: Workflow Leads V1
  - name: Workflows
  - name: Workflows V1
paths:
  /voices:
    get:
      tags:
        - Voices
      summary: Get all voices with optional filtering and pagination
      description: >-
        **Legacy endpoint - deprecated, scheduled for removal on July 31,
        2026.** Use the `/v1` version for new integrations. 
      operationId: VoicesController_findAll
      parameters:
        - name: provider
          required: false
          in: query
          description: Filter by provider name
          schema:
            enum:
              - elevenlabs
              - smallestai
              - sarvam
              - cartesia
            type: string
        - name: accent
          required: false
          in: query
          description: Filter by accent
          schema:
            enum:
              - indian
              - british
              - american
              - canadian
              - african
              - australian
              - swedish
            type: string
        - name: gender
          required: false
          in: query
          description: Filter by gender
          schema:
            enum:
              - male
              - female
              - non-binary
            type: string
        - name: name
          required: false
          in: query
          description: Search by voice name
          schema:
            example: English
            type: string
        - name: page
          required: false
          in: query
          description: Page number (starts from 1)
          schema:
            default: '1'
            example: '1'
            type: number
        - name: limit
          required: false
          in: query
          description: 'Number of records per page (default: 20, max: 50)'
          schema:
            default: '20'
            example: '20'
            type: number
        - name: language_id
          required: false
          in: query
          description: Filter voices that support a specific language ID
          schema:
            example: abc12345678901
            type: string
        - name: llm_id
          required: false
          in: query
          description: Filter voices compatible with a specific LLM ID (S2S models only)
          schema:
            example: abc12345678901
            type: string
      responses:
        '200':
          description: Return voices with optional filtering and pagination
          content:
            application/json:
              schema:
                type: object
                properties:
                  voices:
                    type: array
                    items:
                      type: object
                  total:
                    type: number
                  page:
                    type: number
                  limit:
                    type: number
                  totalPages:
                    type: number
        '400':
          description: Invalid filter parameters
      deprecated: true
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````