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

# Get Voice

`GET /voices/{voice_id}`

Retrieve a single voice by its UUID.

Result is cached in Redis (TTL controlled by the ``VOICE_CACHE_TTL`` env var,
default 72 h).

Args:
    voice_id: UUID of the voice to retrieve.
    x_api_key: Bearer API key from the ``x-api-key`` header.
    token_service: Injected token validation service.
    request: Raw FastAPI ``Request``.
    version: API version extracted from the ``version`` request header.

Returns:
    VoiceResponse: Voice metadata.

Raises:
    VoiceNotFound: When the voice does not exist or is not accessible by the caller.

## Path parameters

- `voice_id` string, uuid, required

## Headers

- `version` 'v1'
- `X-Api-Key` string

## Response `200`

Successful Response

- VoiceResponse
  - `voice_id` string, uuid, required
  - `name` string, required
  - `description` string, nullable, required
  - `language` string, nullable, required
  - `gender` 'Male' | 'Female' | 'Neutral' | 'Unspecified', required
  - `accent` string, nullable, required
  - `style` string, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `voice_type` 'PREDEFINED' | 'CUSTOM', required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/async/apis/text-to-speech-api-service.md) · [All operations](https://skmtc.dev/async/apis/text-to-speech-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/async/text-to-speech-api-service/revisions/9bfc541b6e9a/schema)