> ## 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 available voices for the frontend agent-building experience.

## List Voices

Retrieves a list of all available public voices that can be used for agents.

### Request

**Method:** `GET`\
**Endpoint:** `/api/list-voices`\
**Headers:** None required

### Response

**Success Response (200):**

```json theme={null}
[
  {
    "name": "string",
    "id": "string",
    "gender": "string",
    "language": "string",
    "tags": ["string"],
    "accent": "string",
    "isMultiLingualSupport": boolean
  }
]
```

**Error Responses:**

* `500 Internal Server Error`: Server error

### Example

```bash theme={null}
curl -X GET https://app.phonely.ai/api/list-voices
```


## 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, use for set agent's voice
        gender:
          type: string
          description: Gender of the voice
        language:
          type: string
          description: Support language of 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

````