Browse Voices

List voices via GET /v3/voices; inspect one via GET /v3/voices/{voice_id}. To create a new voice instead, see Design Voices or Instant Voice Clone. For TTS on a catalog voice, see Third Party Speech.

Quick Example

curl -X GET "https://api.heygen.com/v3/voices?language=English&gender=female&limit=5" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

{
  "data": [
    {
      "voice_id": "1bd001e7e50f421d891986aad5c8bbd2",
      "name": "Sara",
      "language": "English",
      "gender": "female",
      "type": "public",
      "preview_audio_url": "https://files.heygen.ai/voice/preview_sara.mp3",
      "support_pause": true,
      "support_locale": true
    }
  ],
  "has_more": true,
  "next_token": "eyJsYXN0X2lkIjoiMTIzIn0"
}

Query Parameters

Parameter	Type	Required	Default	Description
`type`	string	No	`"public"`	`"public"` for the shared library or `"private"` for your cloned voices.
`engine`	string	No	—	Filter by speech engine: `"orca"` (HeyGen Voice), `"starfish"`, or `"elevenlabs"`. Only compatible voices are returned.
`language`	string	No	—	Filter by language (e.g. `"English"`, `"Spanish"`).
`gender`	string	No	—	Filter by `"male"` or `"female"`.
`limit`	integer	No	`20`	Results per page (1–100).
`token`	string	No	—	Opaque cursor token for the next page (from a previous response’s `next_token`).

Response Fields

Each voice object in the data array contains:

Field	Type	Description
`voice_id`	string	Unique identifier. Pass this to `POST /v3/voices/speech`, `POST /v3/videos`, or `POST /v3/video-agents`.
`name`	string	Display name of the voice.
`language`	string	Primary language (e.g. `"English"`).
`gender`	string	`"male"` or `"female"`.
`type`	string	`"public"` (shared library) or `"private"` (your cloned voice).
`preview_audio_url`	string or null	URL to a short audio preview.
`support_pause`	boolean	Whether the voice supports `<break>` pause tags.
`support_locale`	boolean	Whether the voice supports locale variants (e.g. `en-US` vs `en-GB`).

Filtering Examples

By Language

curl

curl -X GET "https://api.heygen.com/v3/voices?language=Spanish" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

By Gender

curl

curl -X GET "https://api.heygen.com/v3/voices?gender=male" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

Your Private (Cloned) Voices

curl

curl -X GET "https://api.heygen.com/v3/voices?type=private" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

Voices for one engine

Every catalog voice works with POST /v3/voices/speech. To list the voices a given engine can speak, filter by it; each voice also reports available_engines and default_engine:

curl

curl -X GET "https://api.heygen.com/v3/voices?engine=elevenlabs" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

Pagination

If has_more is true, pass the next_token value as the token query parameter to fetch the next page.

curl

curl -X GET "https://api.heygen.com/v3/voices?token=eyJsYXN0X2lkIjoiMTIzIn0" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

Auth

User Info

Models

Video Generation

Video Composition

On Brand

Realtime Video

Avatar Management

Voice Management

Video Translation

Lipsync

Tools

Asset Management

Batches

Webhook

Limits

Socials

For Agents

Integrations

Quick Example

Query Parameters

Response Fields

Filtering Examples

By Language

By Gender

Your Private (Cloned) Voices

Voices for one engine

​Quick Example

​Query Parameters

​Response Fields

​Filtering Examples

​By Language

​By Gender

​Your Private (Cloned) Voices

​Voices for one engine

​Pagination

Quick Example

Query Parameters

Response Fields

Filtering Examples

By Language

By Gender

Your Private (Cloned) Voices

Voices for one engine

Pagination