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

# List Voices

> Return the public voices available for agents.

Returns public voice records with their IDs and display metadata, including language, accent, tags, gender, and multilingual support when available.

This endpoint does not require authentication.


## OpenAPI

````yaml GET /list-voices
openapi: 3.0.1
info:
  title: Phonely API
  description: API for Phonely services including agent management and call summaries
  version: 1.0.0
servers:
  - url: https://app.phonely.ai/api
security: []
paths:
  /list-voices:
    get:
      summary: List available voices
      description: Get a list of all available voices for your agent
      responses:
        '200':
          description: List of available voices
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Voice'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Voice:
      type: object
      properties:
        name:
          type: string
          description: Name of the voice
        id:
          type: string
          description: Unique voice ID to use when updating an agent
        gender:
          type: string
          description: Gender of the voice
        language:
          type: string
          description: Language supported by the voice
        tags:
          type: array
          items:
            type: string
          description: Feature tags associated with the voice
        accent:
          type: string
          description: Accent of the voice
        isMultiLingualSupport:
          type: boolean
          description: Whether the voice supports multiple languages
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error code or identifier
        message:
          type: string
          description: Detailed error message

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.