Skip to main content
GET
/
v1
/
voice
/
voices
List Voices
curl --request GET \
  --url https://api.example.com/v1/voice/voices \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "count": 123,
  "voices": [
    {
      "voice_id": "<string>",
      "voice_name": "<string>",
      "provider": "<string>",
      "gender": "<string>",
      "accent": "<string>",
      "age": "<string>"
    }
  ],
  "powered_by": "<string>"
}

​
Description

Returns all available text-to-speech voices that can be used when creating or updating voice agents. Use the voice_id from the response when setting the voice for your agents.

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Response Fields

​
success
boolean
Whether the request was successful
​
count
integer
Total number of available voices
​
voices
array
Array of voice objects
​
powered_by
string
Always returns "Teli"

​
Example Request

curl -X GET "https://api.teli.ai/v1/voice/voices" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "count": 3,
  "voices": [
    {
      "voice_id": "11labs-Adrian",
      "voice_name": "Adrian",
      "provider": "teli-voice",
      "gender": "male",
      "accent": "American",
      "age": "Young"
    },
    {
      "voice_id": "11labs-Sarah",
      "voice_name": "Sarah",
      "provider": "teli-voice",
      "gender": "female",
      "accent": "American",
      "age": "Middle-aged"
    },
    {
      "voice_id": "openai-alloy",
      "voice_name": "Alloy",
      "provider": "teli-voice",
      "gender": "female",
      "accent": "American",
      "age": "Young"
    }
  ],
  "powered_by": "Teli"
}

​
Usage with Agents

Use the voice_id when creating or updating a voice agent: 
{
  "agent_type": "voice",
  "agent_name": "Sales Agent",
  "voice_id": "11labs-Adrian",
  "starting_message": "Hello! How can I help you today?",
  "prompt": "You are a helpful sales assistant..."
}

​
Voice Providers

All voices are provided through Teli Voice and include voices from multiple high-quality TTS providers:
ProviderVoice ID PrefixQuality
Teli Voice (ElevenLabs)11labs-Ultra-realistic
Teli Voice (OpenAI)openai-Natural
Teli Voice (Deepgram)deepgram-Fast
Teli Voice (Cartesia)cartesia-Expressive

​
Notes

  • Voice availability may vary based on your plan
  • Some voices support multiple languages
  • Voice IDs are stable and can be stored for agent configuration
  • Use gender and accent filters in your UI to help users find the right voice