# List custom voices

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

Returns the signed-in account's custom voices, so you can find a voice ID by name.

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

## Responses

### 200: Custom voices in the voice library

- `voices` (array of CustomVoice, required)
  - `id` (string, required): Voice ID for `POST /v1/voice` and `DELETE /v1/custom-voices/{id}`
  - `name` (string, required)
  - `imageUrl` (string or null, required): Avatar URL, or null when the voice has no image

```json
{
  "voices": [
    {
      "id": "3f6c2a9e-8d41-4c57-9b0e-2f1d7a4c8e10",
      "name": "My voice",
      "imageUrl": null
    }
  ]
}
```

### 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/custom-voices \
  -H "Authorization: Bearer $VOICES_AI_API_KEY"
```

```javascript
const res = await fetch('http://127.0.0.1:19470/v1/custom-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/custom-voices",
    headers={"Authorization": f"Bearer {os.environ['VOICES_AI_API_KEY']}"},
)
print(res.json())
```
