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

# Get available voices

> Retrieve all available voices for assistant configuration

This endpoint returns a list of all available voices that can be used when creating or updating assistants, with optional filtering by assistant mode and language.

### Query Parameters

**mode** `string`

Filter voices by assistant mode. Options: `pipeline`, `multimodal`, `dualplex`

**language\_id** `integer`

Filter voices by language ID. Use the [Get Languages](https://docs.receptonic.com/api-reference/assistants/get-languages.md) endpoint to get available language IDs.

**synthesizer\_provider\_id** `integer`

Filter voices by TTS provider ID (e.g. ElevenLabs, Cartesia, Azure). Use the [Get Synthesizer Providers](https://docs.receptonic.com/api-reference/assistants/get-synthesizer-providers.md) endpoint to get available provider IDs.

**gender** `string`

Filter voices by gender (e.g., `male`, `female`).

**age** `string`

Filter voices by age category (e.g., `Young`, `Middle aged`).

**accent** `string`

Filter voices by accent (e.g., `American`, `British`).

**search** `string`

Free-text search across voice name, accent, age, and gender.

### Response fields

**data** `array`

**properties**

**id** `integer`

The unique identifier of the voice

**name** `string`

The display name of the voice

**language\_id** `integer`

The language ID this voice is associated with

**gender** `string`

The gender of the voice (male/female)

**preview\_url** `string`

URL to an audio sample of the voice. Can be used to let users preview voices before selecting one.

**accent** `string`

The accent of the voice (e.g., "American", "British"). May be `null`.

**age** `string`

The age category of the voice (e.g., "Young", "Middle aged"). May be `null`.

**synthesizer\_provider\_id** `integer`

The TTS provider ID this voice belongs to. Use the [Get Synthesizer Providers](https://docs.receptonic.com/api-reference/assistants/get-synthesizer-providers.md) endpoint to resolve provider names. May be `null`.

```json 200 Response theme={null}
[
  {
    "id": 1,
    "name": "Alloy",
    "language_id": 1,
    "gender": "female",
    "preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": null
  },
  {
    "id": 10,
    "name": "Zephyr",
    "language_id": 1,
    "gender": "female",
    "preview_url": "https://gstatic.com/aistudio/voices/samples/Zephyr.wav",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": 1
  },
  {
    "id": 11,
    "name": "Puck",
    "language_id": 1,
    "gender": "male",
    "preview_url": "https://gstatic.com/aistudio/voices/samples/Puck.wav",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": 1
  }
]
```

### Notes

* Use the `id` field as `voice_id` when creating or updating assistants
* Filter by `mode` to get only voices compatible with your intended assistant type
* Filter by `language_id` to get voices for a specific language
* Filter by `gender`, `age`, or `accent` to narrow the list, or use `search` for free-text matching across those fields
* If no filters are provided, all available voices are returned
* Only voices that are public or belong to the authenticated user are returned


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.