---
title: "List Voices"
method: POST
path: "/voices"
tags: ["Synth Voices"]
---

# List Voices

`POST /voices`

List voices accessible to the authenticated token.

Supports filtering and pagination via ``VoiceListRequest`` fields.

Args:
    request: Optional filter/pagination parameters (defaults to an empty request).
    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:
    VoiceListResponse: Paginated list of voices with metadata.

## Headers

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

## Request body

- VoiceListRequest
  - `limit` integer, nullable
  - `after` string, uuid, nullable
  - `my_voice` boolean, nullable
  - `gender` 'Male' | 'Female' | 'Neutral' | 'Unspecified'
  - `language` string, nullable
  - `accent` string, nullable
  - `style` string, nullable
  - `api_version` string, nullable
  - `model_id` 'async_flash_v1.0' | 'async_flash_v1.5' | 'async_pro_v1.0'
  - `voice_type` 'PREDEFINED' | 'CUSTOM'
  - `min_quality` integer, nullable
  - `max_quality` integer, nullable
  - `name_contains` string, nullable

## Response `200`

Successful Response

- VoiceListResponse
  - `voices` VoiceResponse[], required
    - `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
  - `next_cursor` string, nullable

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