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

# Get Assistant Voices

> Retrieves a list of available voices for assistants, optionally filtered by language.

List available voices for assistant configuration. You can optionally filter by language when building assistant creation or configuration workflows.

## When to use

* Populate a voice picker in a custom assistant setup UI.
* Validate that a desired language has available voices before creating an assistant.
* Let internal operators compare voice options without opening the Ringg dashboard.

## Integration notes

Voice availability can vary by language and provider. Store the selected voice ID only after the operator confirms the assistant configuration.


## OpenAPI

````yaml get /agent/voices
openapi: 3.0.0
info:
  title: Ringg AI API Documentation
  description: >-
    This is the documentation for the Ringg AI APIs. The Ringg AI API follows
    RESTful principles, making it intuitive and easy to integrate with your
    applications. All API requests should be made to the base URL. The API
    accepts and returns data in JSON format. Ensure your requests include the
    appropriate Content-Type header for POST and PATCH requests.
  version: 2.0.0
servers:
  - url: https://prod-api.ringg.ai/ca/api/v0
security: []
tags:
  - name: workspace
    description: Endpoints for managing your workspace.
  - name: agent
    description: Endpoints for managing assistants (agents).
  - name: calling
    description: Endpoints for making and managing calls.
  - name: campaign
    description: Endpoints for managing campaigns.
  - name: analytics
    description: Endpoints for accessing call analytics and performance metrics.
  - name: termination
    description: Endpoints for terminating active calls using different methods.
  - name: knowledgebase
    description: Endpoints for managing knowledge bases.
paths:
  /agent/voices:
    get:
      tags:
        - agent
      summary: Get Assistant Voices
      description: >-
        Retrieves a list of available voices for assistants, optionally filtered
        by language.
      operationId: getAssistantVoices
      parameters:
        - name: X-API-KEY
          in: header
          description: (Required) Your Ringg AI API key.
          required: true
          schema:
            type: string
            example: 7251cb4b-3373-43a4-844c-b27a1d45e0c9
        - name: language
          in: query
          description: >-
            Filter voices by language (e.g., 'en-US', 'hi-IN'). Multiple
            languages can be comma-separated.
          schema:
            type: string
      responses:
        '200':
          description: 'Successful Response: A list of available voices.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  voices:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 3b5c7d2a-8e9f-4a1b-9c6d-2e5f8a7b3c4d
                        name:
                          type: string
                          example: Sarah
                        languages:
                          type: array
                          items:
                            type: string
                          example:
                            - en-US
                            - en-GB
                        voice_previews:
                          type: object
                          properties:
                            en-US:
                              type: string
                              format: uri
                              example: https://example.com/voice-preview-en-us.mp3
                        image_url:
                          type: string
                          format: uri
                          example: https://example.com/voice-avatar.jpg
                          nullable: true
                        gender:
                          type: string
                          example: female
                        created_at:
                          type: string
                          format: date-time
                          example: '2024-12-16T13:03:29.947147+00:00'
                        updated_at:
                          type: string
                          format: date-time
                          example: '2024-12-16T13:03:29.947147+00:00'
        '401':
          description: Unauthorized - Invalid or missing API key.
        '500':
          description: Internal Server Error - Something went wrong on our end.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: error
                  message:
                    type: string
                    example: Failed to fetch agent voices

````