# List available voices

`GET http://127.0.0.1:19470/v1/voices`

Returns every voice in your voice library: the catalog (effects such as
Clean Mic and Robot included), your custom voices and the Community voices
you added to your voices. Clean Mic comes first.

Authenticate with `Authorization: Bearer <API key>` (key from Settings > Developer in Voices AI Live).

## Responses

### 200: List of available voices

- `voices` (array of Voice, required)
  - `id` (string, required): Unique voice identifier
  - `name` (string, required): Display name
  - `imageUrl` (string or null, required): URL to the voice avatar image; custom voices may have none
  - `isPro` (boolean, required): Whether this voice needs a Live subscription. Only a few voices are free; custom and Community voices always need one.
  - `isCustom` (boolean, required): Whether this is one of your custom voices
  - `isCommunity` (boolean): Whether this is a Community voice you added to your voices

```json
{
  "voices": [
    {
      "id": "fx_clean_mic",
      "name": "Clean Mic",
      "imageUrl": "https://cdn.getvoices.ai/voice_images/fx_clean_mic.webp",
      "isPro": false,
      "isCustom": false,
      "isCommunity": false
    },
    {
      "id": "voice_hannah",
      "name": "Hannah",
      "imageUrl": "https://cdn.getvoices.ai/voice_images/voice_hannah.webp",
      "isPro": false,
      "isCustom": false,
      "isCommunity": false
    },
    {
      "id": "hazel",
      "name": "Hazel",
      "imageUrl": "https://cdn.getvoices.ai/voice_images/hazel.webp",
      "isPro": true,
      "isCustom": false,
      "isCommunity": false
    },
    {
      "id": "7b1e4d2a-5c3f-4e8a-9d6b-1a2c3e4f5a6b",
      "name": "Night Narrator",
      "imageUrl": null,
      "isPro": true,
      "isCustom": false,
      "isCommunity": true
    }
  ]
}
```

### 401: Invalid or missing API key

- `error` (string, required): Error message

```json
{
  "error": "Invalid or missing API key"
}
```

## Examples

```bash
curl http://127.0.0.1:19470/v1/voices \
  -H "Authorization: Bearer $VOICES_AI_API_KEY"
```

```javascript
const res = await fetch('http://127.0.0.1:19470/v1/voices', {
  headers: {
    Authorization: `Bearer ${process.env.VOICES_AI_API_KEY}`,
  },
});
const data = await res.json();
```

```python
import os
import requests

res = requests.get(
    "http://127.0.0.1:19470/v1/voices",
    headers={"Authorization": f"Bearer {os.environ['VOICES_AI_API_KEY']}"},
)
print(res.json())
```
