---
title: "Retrieve Available Voices"
method: GET
path: "/user/assistants/voices"
tags: ["Assistants"]
---

# Retrieve Available Voices

`GET /user/assistants/voices`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/assistants/voices`
- Auth: HTTP bearer

Retrieve all available voices for assistant configuration

[Docs](https://docs.famulor.io/api-v1/assistants/voices)

## Query parameters

- `mode` 'pipeline' | 'multimodal' | 'dualplex'
- `language_id` integer

## Response `200`

response

- object[]
  - `data` object[]
    - `id` integer: The unique identifier of the voice
    - `name` string: The display name of the voice
    - `language_id` integer: The language ID associated with this voice
    - `gender` string: The gender of the voice (male/female)
    - `preview_url` string: URL to an audio sample of the voice. Can be used to allow users to preview the voice before selecting it.
    - `accent` string: The accent of the voice (e.g., "American", "British"). Can be `null`.
    - `age` string: The age category of the voice (e.g., "Young", "Middle aged"). Can be `null`.
    - `synthesizer_provider_id` integer: The TTS provider ID to which this voice belongs. Use the [Retrieve Synthesizer Providers](/en/api-reference/assistants/synthesizer-providers) endpoint to resolve provider names. Can be `null`.

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)