---
title: "Get Voices Batch"
method: POST
path: "/voices/batch"
tags: ["Synth Voices"]
---

# Get Voices Batch

`POST /voices/batch`

Retrieve multiple voices in a single request.

Args:
    payload: List of voice UUIDs to fetch.
    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:
    List[VoiceResponse]: Voice metadata for each requested UUID.

## Headers

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

## Request body

- VoiceBatchRequest
  - `voice_ids` string[], required

## 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)