---
title: "List Voices (v2)"
method: GET
path: "/v2/voices"
tags: ["Deprecated"]
deprecated: true
---

# List Voices (v2)

`GET /v2/voices`

## Request

- Base URL: `https://api.typecast.ai`
- URL: `https://api.typecast.ai/v2/voices`
- Auth: API key in header `X-API-KEY`

> **Deprecated.**

Lists all available voice models with enhanced metadata and filtering capabilities (V2).

This endpoint returns an enhanced voice list with model-grouped emotion support and additional metadata including gender, age group, and use cases. Each voice can support multiple models with their respective emotion sets.

**Key Features:**
- **Model Grouping**: Each voice includes a `models` array showing all supported TTS models and their available emotions
- **Enhanced Metadata**: Includes gender (male/female), age group (child/teenager/young_adult/middle_age/elder), and use cases
- **Advanced Filtering**: Filter by model, gender, age, and use cases to find voices matching specific requirements

**Use Cases:**
- Voice selection UI with demographic filters
- Finding voices suitable for specific content types (e.g., Ads, Audiobook, eLearning)
- Discovering which emotions are available for each model version

## Query parameters

- `model` 'ssfm-v30' | 'ssfm-v21': TTS model version to use for speech synthesis. Different models offer varying capabilities and quality levels. Available models: - **ssfm-v30**: Latest model with improved prosody and additional emotion presets (recommended) - **ssfm-v21**: Stable production model with proven reliability and consistent quality
- `gender` 'male' | 'female': Gender classification enum - Converts database values (Korean) to API values (English). Available values: - **male**: Male voice - **female**: Female voice
- `age` 'child' | 'teenager' | 'young_adult' | 'middle_age' | 'elder': Age group classification enum - Converts database values (Korean) to API values (English). Available values: - **child**: Child voice (under 12 years old) - **teenager**: Teenage voice (13-19 years old) - **young_adult**: Young adult voice (20-35 years old) - **middle_age**: Middle-aged voice (36-60 years old) - **elder**: Elder voice (over 60 years old)
- `use_cases` 'Announcer' | 'Anime' | 'Audiobook' | 'Conversational' | 'Documentary' | 'E-learning' | 'Rapper' | 'Game' | 'Tiktok/Reels' | 'News' | 'Podcast' | 'Voicemail' | 'Ads': Voice use case categories for content type filtering. Each voice is tagged with one or more use cases indicating its suitability for specific content types. **Available Use Cases:** - **Announcer**: Public announcements and presentations - **Anime**: Animation and character voices - **Audiobook**: Long-form narration and storytelling - **Conversational**: Chatbots and conversational AI - **Documentary**: Documentary narration and commentary - **E-learning**: Educational content and tutorials - **Rapper**: Rap and music performance - **Game**: Video game characters and narration - **Tiktok/Reels**: Short-form social media content - **News**: News broadcasting - **Podcast**: Broadcasting and podcast production - **Voicemail**: IVR systems and voice assistants - **Ads**: Advertising and promotional content
- `voice_type` 'original' | 'custom': Voice type classification. - `original` — Typecast-provided stock voices available to every account. - `custom` — Voices the user created by uploading or cloning their own sample.

## Response `200`

Success - Returns list of voice models with enhanced metadata

- VoiceV2[]
  - `age` 'child' | 'teenager' | 'young_adult' | 'middle_age' | 'elder': Age group classification enum - Converts database values (Korean) to API values (English). Available values: - **child**: Child voice (under 12 years old) - **teenager**: Teenage voice (13-19 years old) - **young_adult**: Young adult voice (20-35 years old) - **middle_age**: Middle-aged voice (36-60 years old) - **elder**: Elder voice (over 60 years old)
  - `gender` 'male' | 'female': Gender classification enum - Converts database values (Korean) to API values (English). Available values: - **male**: Male voice - **female**: Female voice
  - `models` ModelInfo[], required: List of supported TTS models with their available emotions (e.g., [{'version': 'ssfm-v21', 'emotions': ['happy', 'sad']}])
    - `version` 'ssfm-v30' | 'ssfm-v21', required: TTS model version to use for speech synthesis. Different models offer varying capabilities and quality levels. Available models: - **ssfm-v30**: Latest model with improved prosody and additional emotion presets (recommended) - **ssfm-v21**: Stable production model with proven reliability and consistent quality
    - `emotions` string[], required: List of supported emotions for this model
  - `voice_id` string, required: Unique voice identifier. Built-in voices use the `tc_` prefix (e.g., `tc_60e5426de8b95f1d3000d7b5`); cloned custom voices created via `POST /v1/voices/clone` use the `uc_` prefix. Use `/v3/voices` to list the built-in and completed custom voices available to your account.
  - `use_cases` string[]: List of use case categories this voice is suitable for
  - `voice_name` string, required: Human-readable name of the voice
  - `voice_type` 'original' | 'custom', required: Voice type classification. - `original` — Typecast-provided stock voices available to every account. - `custom` — Voices the user created by uploading or cloning their own sample.

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `422`: Validation Error - Invalid request parameters

---

[API](https://skmtc.dev/typecast/apis/typecast-api.md) · [All operations](https://skmtc.dev/typecast/apis/typecast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typecast/apis/typecast-api/revisions/41605154de82?raw)