---
title: "Get a voice's detail"
method: GET
path: "/v1/voices/{voice_id}"
tags: ["voices"]
---

# Get a voice's detail

`GET /v1/voices/{voice_id}`

## 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/{voice_id}`
- Auth: none declared

## Path parameters

- `voice_id` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- Voice
  - `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

- `404`: Not Found
- `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)