Skip to main content
GET
/
v1
/
voices
/
list
List Voices
curl --request GET \
  --url https://api.neospeech.io/v1/voices/list \
  --header 'Authorization: <authorization>'
Browse 45+ voices across multiple languages and accents. Each voice has a unique personality and tone.

​
Request

curl "https://api.neospeech.io/v1/voices/list" \
  -H "Authorization: Bearer sk-your-api-key"

​
Parameters

​
Authorization
string
required
Bearer token: Bearer sk-your-api-key
​
gender
string
Filter by male, female, or neutral
​
locale
string
Filter by language like en-US, en-GB, fr-FR, de-DE
​
search
string
Search by name or description
​
limit
integer
Results per page (1-100). Default: 20
​
offset
integer
Skip results for pagination. Default: 0

​
Response

{
  "success": true,
  "data": {
    "voices": [
      {
        "id": "lyra",
        "name": "Lyra",
        "gender": "female",
        "locale": "en-US",
        "description": "Warm, professional American female voice",
        "tags": ["professional", "friendly", "clear"],
        "sample_url": "https://cdn.neospeech.io/samples/lyra.mp3"
      }
    ],
    "pagination": {
      "total": 47,
      "limit": 20,
      "offset": 0,
      "returned": 20
    }
  }
}

​
Common patterns

​
Get all voices

const response = await fetch('https://api.neospeech.io/v1/voices/list', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const { data } = await response.json();
console.log(`Found ${data.pagination.total} voices`);

​
Filter by gender and locale

const params = new URLSearchParams({
  gender: 'female',
  locale: 'en-US'
});

const response = await fetch(
  `https://api.neospeech.io/v1/voices/list?${params}`,
  { headers: { 'Authorization': `Bearer ${apiKey}` } }
);

const { data } = await response.json();
const voices = data.voices;

​
Search voices

params = {'search': 'professional'}
response = requests.get(
    'https://api.neospeech.io/v1/voices/list',
    headers={'Authorization': f'Bearer {apiKey}'},
    params=params
)

voices = response.json()['data']['voices']

​
Professional

Best for business content, presentations, and training:
  • Lyra (female, en-US) - Warm and professional
  • Marcus (male, en-US) - Authoritative and clear
  • Victoria (female, en-GB) - Sophisticated British

​
Conversational

Great for chatbots and casual content:
  • Kai (male, en-US) - Energetic and friendly
  • Zara (female, en-US) - Approachable and warm
  • Oliver (male, en-GB) - Casual British

​
Multilingual

For international audiences:
  • Amélie (female, fr-FR) - French
  • Hans (male, de-DE) - German
  • Yuki (female, ja-JP) - Japanese
  • Sofia (female, es-ES) - Spanish

​
Choosing a voice

Listen to sample audio before deciding. The right voice depends on your use case:
  • Match voice locale to content language for better pronunciation
  • Consider your audience and brand tone
  • Test multiple voices with your actual content
  • Professional contexts usually need neutral, clear voices
  • Entertainment can use more expressive styles
Voice selection significantly impacts how users perceive your content. Take time to test a few options.