List Voices

cURL

curl --request GET \
  --url 'https://api.heygen.com/v3/voices?type=public&limit=20' \
  --header 'x-api-key: <api-key>'

Response Codes

  • 200
  • 400
  • 401
  • 429
{
  "data": [\
    {\
      "voice_id": "<string>",\
      "name": "<string>",\
      "language": "<string>",\
      "gender": "<string>",\
      "support_pause": true,\
      "support_locale": true,\
      "type": "public",\
      "preview_audio_url": "https://files.heygen.ai/voice/preview_sara.mp3"\
    }\
  ],
  "has_more": true,
  "next_token": "<string>"
}

Authorizations

ApiKeyAuth

Key Location Required Description
x-api-key header required HeyGen API key. Obtain from your HeyGen dashboard.

Query Parameters

Name Type Default Description
type enum public Voice type: 'public' for the shared library or 'private' for your cloned voices.
engine string Filter by voice engine (e.g. 'starfish'). When set, only voices compatible with that engine are returned.
language string Filter by language (e.g. 'English').
gender string Filter by gender ('male' or 'female').
limit integer 20 Results per page (1-100). Required range: 1 <= x <= 100
token string Opaque cursor token for the next page.

Response

200

Successful response

Response Body:

  • data: AudioVoiceItem · object[]
  • has_more: boolean — Whether more pages are available
  • next_token: string | null — Opaque cursor for the next page.