# List All Voices
Retrieves a list of all available AI Voices.
**Note:**
* Scroll down to the **Response** section below and expand the status code(s) to view the detailed response schema.
* Refer to the **RESPONSE** section on the right and choose an example to see how the API response appears for each status code.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "heygen-api",
"version": "4.0.8"
},
"servers": [
{
"url": "https://api.heygen.com"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"name": "x-api-key",
"in": "header",
"x-default": ""
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/v2/voices": {
"get": {
"summary": "List All Voices (V2)",
"description": "List All AI Voices (V2)",
"operationId": "list-voices-v2",
"responses": {
"200": {
"description": "Voices retrieved successfully - Expand to view the detailed response schema.",
"content": {
"application/json": {
"examples": {
"Result": {
"value": {
"error": null,
"data": {
"voices": [
{
"voice_id": "73c0b6a2e29d4d38aca41454bf58c955",
"language": "English",
"gender": "Female",
"name": "Cerise - Cheerful",
"preview_audio": "https://static.heygen.ai/voice_preview/KotgDpZPtr63SDnTfgdYxb.wav",
"support_pause": false,
"emotion_support": false,
"support_interactive_avatar": false,
"support_locale": false
},
{
"voice_id": "55f8c0f546884f9cbdefa113f5e7b682",
"language": "Multilingual",
"gender": "female",
"name": "Elizabeth - Friendly",
"preview_audio": "",
"support_pause": false,
"emotion_support": true,
"support_interactive_avatar": true,
"support_locale": false
},
{
"voice_id": "5700372f7c364088a5affaef8d903474",
"language": "Multilingual",
"gender": "Male",
"name": "Paul - Serious",
"preview_audio": "",
"support_pause": false,
"emotion_support": true,
"support_interactive_avatar": true,
"support_locale": false
}
]
}
}
}
},
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Displays error message when the request fails; null if the request is successful."
},
"data": {
"type": "object",
"properties": {
"voices": {
"type": "array",
"items": {
"properties": {
"voice_id": {
"type": "string",
"description": "Unique identifier of the voice."
},
"language": {
"type": "string",
"description": "The primary language of the voice (e.g., \"English\", \"Arabic\")."
},
"gender": {
"type": "string",
"description": "Gender of the voice. Possible values are 'female', 'male', or 'unknown'."
},
"name": {
"type": "string",
"description": "The display name of the voice."
},
"preview_audio": {
"type": "string",
"description": "URL to the sample audio preview for this voice."
},
"support_pause": {
"type": "boolean",
"description": "Indicates whether the voice supports inserting pauses during speech."
},
"emotion_support": {
"type": "boolean",
"description": "Indicates whether the voice supports selecting different emotions (e.g., happy, sad, excited)."
},
"support_interactive_avatar": {
"type": "boolean",
"description": "Indicates whether the voice can be used with interactive avatars, enabling real-time conversational experiences."
},
"support_locale": {
"type": "boolean",
"description": "Indicates whether the voice supports specific locales. These can be retrieved from List All Locales for Voices endpoint. "
}
},
"type": "object"
},
"description": "An array of voice objects. Each object contains details about a specific AI voice."
}
},
"description": "Contains the list of voices."
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```