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

# Voices

> Browse Chariot's stock voices, filter the catalog, and clone your own custom voices.

Every synthesis request takes a `voice_id`. Chariot provides a set of **stock voices** shared across all workspaces, and lets you create **custom voices** by cloning from an audio sample.

## Listing voices

[`GET /v1/voices`](/api-reference/endpoint/get-voices) returns the voices available to your workspace, stock voices plus your own custom ones.

```bash theme={null}
curl "https://api.chariot.in/v1/voices?limit=100" \
  -H "chariotai-api-key: YOUR_API_KEY"
```

Each voice includes its `voice_id`, name, language, accent, gender, and a preview sample URL:

```json theme={null}
{
  "total_voices": 8,
  "data": [
    {
      "voice_id": "bac7d666-094d-4698-91fa-741d60fce662",
      "voice_name": "Matt",
      "language": "en",
      "accent": "american",
      "gender": "male",
      "voice_sample": "https://.../sample.wav"
    }
  ]
}
```

## Filtering

Narrow the catalog with query parameters. Combine them freely:

| Parameter    | Values                                                                                   |
| ------------ | ---------------------------------------------------------------------------------------- |
| `language`   | `en`, `hi`                                                                               |
| `accent`     | `american`, `british`, `indian`                                                          |
| `gender`     | `male`, `female`, `neutral`                                                              |
| `age`        | `young`, `middle_aged`, `old`                                                            |
| `use_cases`  | `conversational`, `commercial`, `narration`, `customer_support`, `wellness` (repeatable) |
| `voice_type` | `stock_voice`, `custom_voice`                                                            |
| `voice_name` | Case-insensitive substring match                                                         |
| `sort`       | `desc` (default), `asc`                                                                  |

```bash theme={null}
curl "https://api.chariot.in/v1/voices?language=hi&gender=female" \
  -H "chariotai-api-key: YOUR_API_KEY"
```

## Stock voices

Chariot ships these ready-to-use voices:

| Name    | Language | Accent   | Gender |
| ------- | -------- | -------- | ------ |
| Matt    | English  | American | Male   |
| Mia     | English  | American | Female |
| Ryan    | English  | British  | Male   |
| Emma    | English  | British  | Female |
| Karan   | Hindi    | Indian   | Male   |
| Darshan | Hindi    | Indian   | Male   |
| Meera   | Hindi    | Indian   | Female |
| Neha    | Hindi    | Indian   | Female |

<Note>
  Voice ids are stable, but the catalog grows over time. Fetch `GET /v1/voices` at runtime rather than hardcoding the full list.
</Note>