---
title: "List Voices"
method: GET
path: "/v1/tts/max/voices"
tags: ["Voice AI Beta — Max"]
---

# List Voices

`GET /v1/tts/max/voices`

## Request

- Base URL: `https://genaipro.io/api`
- URL: `https://genaipro.io/api/v1/tts/max/voices`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/genaipro/apis/genaipro-api/docs/v1/tts/max/voices/get.ts> (a function with typed inputs; its response is checked against the schema)

The full Max preset voice catalog in one response (no paging, no query parameters). Use an item's `id` as `voice_id`. `preview_url` is a path on this API (`/v1/tts/max/voices/sample/{id}`): prepend the API base URL to fetch the preview audio.
> **Rate limit:** 60 requests/minute

## Response `200`

Voice catalog

- object
  - `data` TtsMaxVoice[]
    - `id` string: Use as `voice_id`
    - `name` string
    - `description` string
    - `language` string: ISO-639-1 code of the voice's main language
    - `gender` 'male' | 'female'
    - `age` 'Child' | 'Young' | 'Middle-aged' | 'Elderly'
    - `accent` string: Regional accent (empty = standard)
    - `tags` object[]: Voice character and use-case labels
      - `label` string
    - `preview_url` string: Preview path — prepend the API base URL
  - `next_page` unknown
  - `has_more` boolean

## Other responses

- `429`: Rate limit exceeded
- `502`: Catalog temporarily unavailable — retry later

## Changes

- **2026-10-29** `8e065c159192`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/genaipro/apis/genaipro-api/changes/v1/tts/max/voices/get.md)

---

[API](https://skmtc.dev/genaipro/apis/genaipro-api.md) - [All operations](https://skmtc.dev/genaipro/apis/genaipro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/genaipro/apis/genaipro-api/revisions/264ca07ba262?raw)