Skip to main content
GET
/
v1
/
voices
/
builtin
List built-in voices
curl --request GET \
  --url https://api.topcalls.ai/v1/voices/builtin \
  --header 'Authorization: Bearer <token>'
{
  "realtime": {
    "provider": "<string>",
    "voices": [
      {
        "name": "<string>",
        "description": "<string>",
        "provider": "<string>",
        "mode": "<string>",
        "language": "<string>",
        "gender": "<string>"
      }
    ],
    "default": "<string>"
  },
  "legacy": {
    "elevenlabs": {
      "voices": [
        {
          "name": "<string>",
          "id": "<string>",
          "description": "<string>",
          "provider": "<string>",
          "gender": "<string>",
          "age": "<string>"
        }
      ],
      "default_id": "<string>",
      "note": "<string>"
    },
    "deepgram": {
      "voices": [
        {
          "name": "<string>",
          "description": "<string>",
          "provider": "<string>",
          "language": "<string>",
          "gender": "<string>"
        }
      ],
      "default": "<string>",
      "note": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.topcalls.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use Authorization: Bearer tc_live_xxxxx

Query Parameters

​
mode
enum<string>

Filter by call mode

Available options:
realtime,
legacy
​
provider
enum<string>

Filter by voice provider

Available options:
openai,
elevenlabs,
deepgram
​
language
string

Filter by language code (e.g., en, es, fr, de, it, ja, nl)

​
gender
enum<string>

Filter by voice gender

Available options:
male,
female

Response

Built-in voices grouped by mode and provider

​
realtime
object
​
legacy
object