Skip to main content
GET
/
v2
/
voices
/
{voice_id}
cURL
curl --request GET \
  --url 'https://api.typecast.ai/v2/voices/tc_60e5426de8b95f1d3000d7b5' \
  --header 'X-API-KEY: <api-key>'
{
  "voice_id": "tc_60e5426de8b95f1d3000d7b5",
  "voice_name": "Olivia",
  "models": [
    {
      "version": "ssfm-v30",
      "emotions": [
        "normal",
        "happy",
        "sad",
        "angry",
        "whisper",
        "toneup",
        "tonedown"
      ]
    },
    {
      "version": "ssfm-v21",
      "emotions": [
        "normal",
        "happy",
        "sad",
        "angry"
      ]
    }
  ],
  "gender": "female",
  "age": "young_adult",
  "use_cases": [
    "Audiobook",
    "E-learning",
    "Ads"
  ],
  "voice_type": "original"
}

Authorizations

​
X-API-KEY
string
header
required

API key for authentication. You can obtain an API key from the Typecast API Console.

Path Parameters

​
voice_id
string
required

Response

Success - Returns detailed information for the requested voice

V2 Voice response model with model-grouped emotions and enhanced metadata

​
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 and are also returned by /v2/voices for the owner.

​
voice_name
string
required

Human-readable name of the voice

​
models
ModelInfo · object[]
required

List of supported TTS models with their available emotions (e.g., [{'version': 'ssfm-v21', 'emotions': ['happy', 'sad']}])

​
voice_type
enum<string>
required

Voice type — original for Typecast-provided stock voices, custom for user-cloned voices.

Available options:
original,
custom
​
gender
enum<string> | null

Voice gender classification (male/female)

Available options:
male,
female
​
age
enum<string> | null

Voice age group classification (child/teenager/young_adult/middle_age/elder)

Available options:
child,
teenager,
young_adult,
middle_age,
elder
​
use_cases
string[]

List of use case categories this voice is suitable for