---
title: "Get Voice By Id"
method: GET
path: "/v1/voices/{voice_id}"
tags: ["Voices"]
---

# Get Voice By Id

`GET /v1/voices/{voice_id}`

## Request

- Base URL: `https://api.liveavatar.com`
- URL: `https://api.liveavatar.com/v1/voices/{voice_id}`
- Auth: API key in header `X-API-KEY`

Get voice by id, with the TTS engines it can be voiced by.

## Path parameters

- `voice_id` string, required

## Response `200`

Successful Response

- ResponseVoiceDetailSchema
  - `code` integer
  - `data` VoiceDetailSchema
    - `id` string, uuid, required
    - `name` string, required
    - `description` string
    - `language` string, required
    - `gender` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `voice_engines` TTSProviderEnum[]: TTS engines that can voice this voice
    - `tags` string[], required
  - `message` string

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `8bc38e64ff31`: 1 warning, 2 info
  - deleted the `cookie` request parameter `la_session`
  - added `#/components/schemas/VoiceDetailSchema` to the `data` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/VoiceSchema` from the `data` response property `anyOf` list for the response status `200`

[Operation history](https://skmtc.dev/liveavatar/apis/live-avatar-api/changes/v1/voices/:voice_id/get.md)

---

[API](https://skmtc.dev/liveavatar/apis/live-avatar-api.md) - [All operations](https://skmtc.dev/liveavatar/apis/live-avatar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/liveavatar/apis/live-avatar-api/revisions/8bc38e64ff31?raw)