> ## 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 TTS Voice Providers

> Retrieve a list of available Text-to-Speech (TTS) voice providers along with their configuration status and search capabilities.

Retrieve a list of all Text-to-Speech (TTS) voice providers available for your Voice Agents, along with their supported querying capabilities.

When building a custom dashboard where users can select a voice for their agent, this endpoint tells you exactly which providers are active and what kind of search interface you should render for them.

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

### Understanding the Provider Metadata

A successful `200 OK` response returns a `providers` array. Each object in this array contains critical configuration flags:

* **`configured`**: A boolean indicating if the provider is fully set up (e.g., the necessary API keys are present in your environment). If this is `false`, you may want to disable or hide this provider in your UI.
* **`supportsSearch`**: If `true`, the provider's API allows you to pass custom text strings to search for specific voice names or characteristics.
* **`supportsFacets`**: If `true`, the provider supports advanced filtering categories (facets) such as filtering by "Accent: British", "Gender: Female", or "Tone: Conversational".


## OpenAPI

````yaml get /config/tts-voice-providers
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-voice-providers:
    get:
      summary: List TTS Voice Providers
      description: >-
        Retrieve a list of available Text-to-Speech (TTS) voice providers along
        with their configuration status and search capabilities.
      responses:
        '200':
          description: Provider metadata list retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  providers:
                    type: array
                    items:
                      type: object
                      properties:
                        providerId:
                          type: string
                          description: The internal ID of the TTS provider.
                          example: elevenlabs
                        displayName:
                          type: string
                          description: The human-readable name of the provider.
                          example: ElevenLabs
                        configured:
                          type: boolean
                          description: >-
                            Indicates whether this provider is currently
                            configured and ready to use in your environment.
                          example: true
                        supportsSearch:
                          type: boolean
                          description: >-
                            Indicates whether this provider supports searching
                            for voices by keyword.
                          example: true
                        supportsFacets:
                          type: boolean
                          description: >-
                            Indicates whether this provider supports filtering
                            voices by facets (e.g., gender, accent, use case).
                          example: true
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````