---
title: "List available voices"
method: GET
path: "/v1/voices"
---

# List available voices

`GET /v1/voices`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/voices`
- Auth: HTTP bearer

The catalog of voices available for an agent's voiceId.

## Query parameters

- `provider` 'elevenlabs' | 'engine'

## Response `200`

Voices

- object
  - `voices` object[], required
    - `id` string, required
    - `name` string, required
    - `gender` 'female' | 'male', required
    - `provider` 'elevenlabs' | 'cartesia' | 'google', required
    - `tone` string, required
    - `description` string, required
    - `languages` string[], required
    - `preview` object, required
      - `studio` string, required
      - `phone` string, required
    - `default` boolean, required

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)