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

# List Voices

> List available voices for TTS generation

Retrieves a paginated list of available voices. Returns both system voices and your custom voices (if any).

```bash Endpoint theme={null}
GET https://api.audixa.ai/v3/voices
```

## Request

**model** `string`

Filter by model compatibility. `base` or `advanced`.

**limit** `integer` (default: 100)

Maximum results to return (1-500).

**offset** `integer` (default: 0)

Number of results to skip.

## Response

**limit** `integer`

Limit used for pagination.

**offset** `integer`

Offset used for pagination.

**length** `integer`

Number of voices returned in this page.

**voices** `array`

List of voice objects.

**Voice Object**

**voice\_id** `string`

Unique identifier to use in `/tts` requests.

**name** `string`

Human-readable name.

**model** `string`

Compatible model: `base` or `advanced`.

**gender** `string`

`Male`, `Female`, or `Neutral`.

**accent** `string`

Voice accent (e.g., `American`, `British`, `Australian`).

**description** `string`

Brief description of the voice characteristics.

**is\_custom** `boolean`

`true` if this is a custom voice created by you.

**free** `boolean`

Voice-access classification used by plan rules. A value of `true` does
not make TTS generation free.

```bash cURL theme={null}
curl -X GET "https://api.audixa.ai/v3/voices?model=base&limit=50" \
  -H "x-api-key: YOUR_API_KEY"
```

```python Python requests theme={null}
import requests

response = requests.get(
    "https://api.audixa.ai/v3/voices",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"model": "base", "limit": 50},
    timeout=30,
)
response.raise_for_status()

for voice in response.json()["voices"]:
    print(f"{voice['name']} ({voice['voice_id']})")
```

```javascript JavaScript fetch theme={null}
const query = new URLSearchParams({ model: 'base', limit: '50' });
const response = await fetch(`https://api.audixa.ai/v3/voices?${query}`, {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
if (!response.ok) throw new Error(await response.text());

const { voices } = await response.json();
for (const voice of voices) {
  console.log(`${voice.name} (${voice.voice_id})`);
}
```

```json 200 OK theme={null}
{
  "limit": 50,
  "offset": 0,
  "length": 2,
  "voices": [
    {
      "voice_id": "am_ethan",
      "name": "Ethan",
      "model": "base",
      "gender": "Male",
      "accent": "American",
      "description": "Clear professional voice",
      "free": true,
      "is_custom": false
    },
    {
      "voice_id": "jake",
      "name": "Jake",
      "model": "advanced",
      "gender": "Male",
      "free": false,
      "is_custom": true
    }
  ]
}
```

## Error Responses

> [accordion] 401 Unauthorized
>
> Missing or invalid API key.
>
> ```json theme={null}
> {
>   "detail": "Invalid or missing API key"
> }
> ```

> [accordion] 429 Too Many Requests
>
> Rate limit exceeded.
>
> ```json theme={null}
> {
>   "detail": "Rate limit exceeded. Please retry after 30 seconds."
> }
> ```


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