> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: List voices
api: "GET /v1/voices"
description: List all available voices, grouped by language or by voice.
gridGap: 30
---

# List voices

`GET` `https://api.vakyam.ai/v1/voices`

Returns all active voices. Pass a returned `voice_name` value as the `voice`
parameter (with its `language`) in synthesis requests.

#### cURL

```bash
curl "https://api.vakyam.ai/v1/voices?group_by=language" \
  -H "Authorization: Bearer $VAKYAM_API_KEY"
```



#### Python

```python
client.voices.list(group_by="language")
```



#### JavaScript

```ts
await client.voices.list({ groupBy: "language" });
```



#### By language

```json
{
  "ta-IN": [
    {
      "voice_name": "Archana",
      "gender": "female"
    },
    {
      "voice_name": "Kiran",
      "gender": "male"
    }
  ],
  "hi-IN": [
    {
      "voice_name": "Priya",
      "gender": "female"
    },
    {
      "voice_name": "Mohan",
      "gender": "male"
    }
  ]
}
```



#### By voice

```json
{
  "Archana": {
    "gender": "female",
    "languages": ["bn-IN", "en-IN", "gu-IN", "hi-IN", "kn-IN", "mr-IN", "ta-IN", "te-IN"]
  },
  "Priya": {
    "gender": "female",
    "languages": ["bn-IN", "en-IN", "gu-IN", "hi-IN", "kn-IN", "mr-IN", "ta-IN", "te-IN"]
  }
}
```

## Authorization

- `Authorization` (string, required) — Bearer token: `Bearer vak_live_<key>`.

## Query parameters

- `group_by` (string, default language) — How to group the response. One of `language` or `voice`.

## Response

The response shape depends on the `group_by` query parameter.

#### group_by=language

Each key is a BCP 47 language code mapping to an array of voices available
    in that language.

    ```json
    {
      "ta-IN": [
        {
          "voice_name": "Archana",
          "gender": "female"
        },
        {
          "voice_name": "Kiran",
          "gender": "male"
        }
      ]
    }
    ```


- `voice_name` (string) — Name of the voice. Use this in synthesis requests.


- `gender` (string) — `male` or `female`.



#### group_by=voice

Each key is a voice/person mapping to that voice's gender and the languages
    it supports.

    ```json
    {
      "Archana": {
        "gender": "female",
        "languages": ["bn-IN", "en-IN", "gu-IN", "hi-IN", "kn-IN", "mr-IN", "ta-IN", "te-IN"]
      }
    }
    ```


- `gender` (string) — `male` or `female`.


- `languages` (string[]) — Languages this voice supports.

---

*Powered by [holocron.so](https://holocron.so)*