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

# List Provider Voices

> Retrieve a filterable, paginated list of available TTS voices for a specific provider.

Fetch the complete, paginated catalog of voices available from a specific Text-to-Speech (TTS) provider.

Whether your users want a "calm, British male" voice from ElevenLabs or an "energetic female" voice from Cartesia, this endpoint allows you to query, filter, and paginate through thousands of available voice models to find the perfect fit for your Voice Agent.

<Info>
  **Authentication Required:** You must include your API key in the `x-api-key` header to authenticate this request.
</Info>

### Required Parameters

* **`providerId`**: This is the only strictly required parameter. You must specify which provider's library you are querying (e.g., `elevenlabs`, `cartesia`, `deepgram`). You can get the list of active providers using the [List TTS Voice Providers](/api-reference/config/list-tts-voice-providers) endpoint.

### Searching & Filtering

If the requested provider supports search and facets (which you can verify via the provider metadata endpoint), you can use the following query parameters to narrow down the results:

* **`q`**: A free-text search string. Pass a name or a descriptive adjective like "warm" or "news anchor".
* **`language`**: Pass a standard ISO code (like `en` or `es`) to only return voices natively trained for that language.
* **`gender`**: Filter the catalog by `male`, `female`, or other provider-supported gender tags.


## OpenAPI

````yaml get /config/tts-voices
openapi: 3.0.3
info:
  title: Lyzr Voice LiveKit API
  version: 1.0.0
servers:
  - url: https://voice-livekit.studio.lyzr.ai/v1
security: []
paths:
  /config/tts-voices:
    get:
      summary: List Provider Voices
      description: >-
        Retrieve a filterable, paginated list of available TTS voices for a
        specific provider.
      parameters:
        - name: providerId
          in: query
          required: true
          description: The internal ID of the TTS provider to query.
          schema:
            type: string
            enum:
              - cartesia
              - elevenlabs
              - deepgram
              - inworld
              - rime
              - sarvam
            example: elevenlabs
        - name: q
          in: query
          description: >-
            A search query to filter voices by name or characteristic (requires
            the provider to support search).
          schema:
            type: string
            example: friendly
        - name: language
          in: query
          description: Filter voices by supported language code (e.g., 'en', 'es').
          schema:
            type: string
            example: en
        - name: gender
          in: query
          description: Filter voices by gender.
          schema:
            type: string
            example: female
        - name: limit
          in: query
          description: The maximum number of voices to return per page.
          schema:
            type: integer
            example: 20
        - name: cursor
          in: query
          description: The pagination cursor to retrieve the next page of results.
          schema:
            type: string
      responses:
        '200':
          description: A paginated list of voices for the requested provider.
          content:
            application/json:
              schema:
                type: object
                properties:
                  voices:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: Xb7hH8MSUJpSbSDYk0k2
                        name:
                          type: string
                          example: Alice - Friendly & Professional
                        gender:
                          type: string
                          example: female
                        language:
                          type: string
                          example: en
                        previewUrl:
                          type: string
                          description: URL to an audio sample of the voice.
                          example: https://example.com/audio/alice_preview.wav
                  nextCursor:
                    type: string
                    description: >-
                      A token used to fetch the next set of results. Null if
                      there are no more pages.
                    example: cGFnZT0y
        '400':
          description: Invalid query parameters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid query params
                  issues:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  example:
                    type: object
                    additionalProperties: true
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````