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

# List available voices

`GET /v1/voices`

## Request

- Base URL: `https://api.beatra.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.beatra.ai/v1/voices`
- Auth: none declared

## Query parameters

- `language` string, nullable: BCP-47 / ISO-639-1 filter
- `gender` string, nullable
- `category` string, nullable: preset | cloned
- `q` string, nullable: Search in display names

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- VoiceList
  - `object` 'list'
  - `data` Voice[], required
    - `voice_id` string, required: Opaque beatra voice handle
    - `display_name` string, required
    - `category` 'preset' | 'cloned', required
    - `language` string, nullable
    - `languages_supported` string[]
    - `gender` 'male' | 'female' | 'neutral', nullable
    - `age` 'adult' | 'child' | 'elder', nullable
    - `accent` string, nullable
    - `use_case` string[]
    - `preview_url` string, nullable
    - `compatible_models` string[]: Models this voice currently resolves on (informational; 'auto' always works)
    - `status` 'processing' | 'ready' | 'failed'
    - `created_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/beatra/apis/agent-service-api.md) · [All operations](https://skmtc.dev/beatra/apis/agent-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beatra/apis/agent-service-api/revisions/58e440556498?raw)