# List voices

Source: https://platform.msingiai.com/docs?page=voices

API base URL: https://api.msingiai.com

Returns the voices currently available for text-to-speech in your workspace.

## Endpoint

```text
GET /v1/voices
```

## Example request

### Bash / cURL

```bash
curl "$MSINGI_BASE_URL/v1/voices" -H "Authorization: Bearer $MSINGI_API_KEY"
```

### Python

```python
requests.get(f"{BASE}/v1/voices", headers={"Authorization": f"Bearer {API_KEY}"}).json()
```

### JavaScript / Node.js

```javascript
await (await fetch(`${BASE}/v1/voices`, { headers: { Authorization: `Bearer ${API_KEY}` } })).json();
```

## Response 200 (application/json)

Voice IDs and their display names.

```json
{
  "voices": [
    { "id": "male", "label": "Male" },
    { "id": "female", "label": "Female 1" }
  ]
}
```

## Response 401 (application/json)

Missing or invalid API key.

## Response 503 (application/json)

The voice catalog is temporarily unavailable.

Choose from the available voices.

[Open Text to speech](https://platform.msingiai.com/playground?operation=tts)

[Documentation index](https://platform.msingiai.com/llms.txt)