GET
/
list-voices
import Retell from 'retell-sdk';

const client = new Retell({
  apiKey: 'YOUR_RETELL_API_KEY',
});

async function main() {
  const voiceResponses = await client.voice.list();

  console.log(voiceResponses);
}

main();
[
  {
    "voice_id": "11labs-Adrian",
    "voice_name": "Adrian",
    "provider": "elevenlabs",
    "accent": "American",
    "gender": "male",
    "age": "Young",
    "preview_audio_url": "https://retell-utils-public.s3.us-west-2.amazonaws.com/adrian.mp3"
  }
]

Authorizations

Authorization
string
header
required

Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"

Response

200
application/json
Successfully retrieved all voices.
voice_id
string
required

Unique id for the voice.

voice_name
string
required

Name of the voice.

provider
enum<string>
required

Indicates the provider of voice.

Available options:
elevenlabs,
openai,
deepgram
gender
enum<string>
required

Gender of voice.

Available options:
male,
female
accent
string

Accent annotation of the voice.

age
string

Age annotation of the voice.

preview_audio_url
string

URL to the preview audio of the voice.