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

# List available voices

> Returns available voices with their supported language codes.
Use this endpoint to discover which voice and language combinations
are valid when creating or updating personas.




## OpenAPI

````yaml /api-reference/v1/personas-v1.yaml get /personas/voices
openapi: 3.0.3
info:
  title: Coval Personas API
  version: 1.0.0
  description: |
    Manage simulated personas used in voice and text evaluations.
  contact:
    name: Coval API Support
    url: https://coval.dev
    email: support@coval.dev
servers:
  - url: https://api.coval.dev/v1
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Personas
    description: Persona CRUD operations
paths:
  /personas/voices:
    get:
      tags:
        - Personas
      summary: List available voices
      description: |
        Returns available voices with their supported language codes.
        Use this endpoint to discover which voice and language combinations
        are valid when creating or updating personas.
      operationId: listPersonasVoices
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListVoicesResponse'
              example:
                voices:
                  - voice_name: aria
                    supported_languages:
                      - bg-BG
                      - da-DK
                      - en-AU
                      - en-IN
                      - en-GB
                      - en-US
                      - fr-FR
                      - de-DE
                      - hi-IN
                      - lt-LT
                      - cmn-CN
                      - pl-PL
                      - es-ES
                      - es-US
                  - voice_name: raju
                    supported_languages:
                      - en
                  - voice_name: isabella
                    supported_languages:
                      - en
                      - es
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    ListVoicesResponse:
      type: object
      description: Response containing available voices with supported languages.
      required:
        - voices
      properties:
        voices:
          type: array
          description: Available voices with their supported language codes
          items:
            $ref: '#/components/schemas/VoiceResource'
    VoiceResource:
      type: object
      description: A voice with its supported language codes.
      required:
        - voice_name
        - supported_languages
      properties:
        voice_name:
          type: string
          description: Coval voice identifier
          example: aria
        supported_languages:
          type: array
          description: BCP-47 language codes supported by this voice
          items:
            type: string
          example:
            - bg-BG
            - da-DK
            - en-AU
            - en-IN
            - en-GB
            - en-US
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: Error code
              example: INVALID_ARGUMENT
            message:
              type: string
              description: Human-readable error message
              example: Invalid voice_name 'invalid'
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: UNAUTHENTICATED
              message: Missing or invalid API key
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INTERNAL
              message: An unexpected error occurred
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key for authentication

````