List Voices

List voices

curl --request GET \
  --url https://www.tryunleashx.com/api/v1/global/voice-list \
  --header 'token: <token>'

const options = {method: 'GET', headers: {token: '<token>'}};

fetch('https://www.tryunleashx.com/api/v1/global/voice-list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.tryunleashx.com/api/v1/global/voice-list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "token: <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.tryunleashx.com/api/v1/global/voice-list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("token", "<token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.tryunleashx.com/api/v1/global/voice-list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["token"] = '<token>'

response = http.request(request)
puts response.read_body

{
  "error": true,
  "code": 123,
  "message": "<string>",
  "timestamp": 123,
  "data": {
    "provider_id": "<string>",
    "provider_name": "<string>",
    "total_count": 123,
    "next_page_token": "<string>",
    "has_more": true,
    "voices": [
      {
        "id": "<string>",
        "title": "<string>",
        "category": "<string>",
        "description": "<string>",
        "url": "<string>",
        "language": "<string>",
        "age": "<string>",
        "gender": "<string>",
        "image": "<string>"
      }
    ]
  }
}

GET

voice-list

List voices

curl --request GET \
  --url https://www.tryunleashx.com/api/v1/global/voice-list \
  --header 'token: <token>'

const options = {method: 'GET', headers: {token: '<token>'}};

fetch('https://www.tryunleashx.com/api/v1/global/voice-list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.tryunleashx.com/api/v1/global/voice-list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "token: <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.tryunleashx.com/api/v1/global/voice-list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("token", "<token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.tryunleashx.com/api/v1/global/voice-list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["token"] = '<token>'

response = http.request(request)
puts response.read_body

{
  "error": true,
  "code": 123,
  "message": "<string>",
  "timestamp": 123,
  "data": {
    "provider_id": "<string>",
    "provider_name": "<string>",
    "total_count": 123,
    "next_page_token": "<string>",
    "has_more": true,
    "voices": [
      {
        "id": "<string>",
        "title": "<string>",
        "category": "<string>",
        "description": "<string>",
        "url": "<string>",
        "language": "<string>",
        "age": "<string>",
        "gender": "<string>",
        "image": "<string>"
      }
    ]
  }
}

Retrieve a list of all available voices from various voice providers for your voice agents. This endpoint supports multiple voice providers including ElevenLabs, OpenAI, Deepgram, Sarvam, and others.

API Endpoint

Endpoint: GET /api/voice-list Authentication: Required (Token header: token or api_access_token)

Query Parameters

Parameter	Type	Required	Description
`provider`	string	Yes	Voice provider name. Supported values: `elevenlabs`, `openai`, `deepgram`, `sarvam`
`page_token`	string	No	Token for pagination to retrieve the next page of results
`limit`	integer	No	Number of voices to return per page (default varies by provider)

{
  "error": false,
  "code": 200,
  "message": "Voices fetched successfully for provider: elevenlabs",
  "timestamp": 1769243432947,
  "data": {
    "provider_id": "1",
    "provider_name": "elevenlabs",
    "total_count": 152,
    "next_page_token": "aHBwNEozVnFOZldBVU9PMGQxVXN8QjE4aWZwOUlOVk4zU0UyUm9vcEE=",
    "has_more": true,
    "voices": [
      {
        "id": "s3I1dCXC0u6BYPeTyp1u",
        "title": "Srivi - Calm, Supportive and Clear",
        "category": "professional",
        "description": "Srivi - Professional BFSI Customer Care Voice - Srivi's voice is professional, clear, and reassuring – perfect for BFSI customer support in Tamil.",
        "url": "https://storage.googleapis.com/eleven-public-prod/database/workspace/ed9b05e6324c457685490352e9a1ec90/voices/s3I1dCXC0u6BYPeTyp1u/zqKmGomJkmpmwDWuG2tH.mp3",
        "language": "ta",
        "age": "middle_aged",
        "gender": "female",
        "image": null
      },
      {
        "id": "hpp4J3VqNfWAUOO0d1Us",
        "title": "Bella - Professional, Bright, Warm",
        "category": "premade",
        "description": "This voice is warm, bright, and professional, characterized by a Standard American accent and a polished, narrative quality.",
        "url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/hpp4J3VqNfWAUOO0d1Us/dab0f5ba-3aa4-48a8-9fad-f138fea1126d.mp3",
        "language": "en",
        "age": "middle_aged",
        "gender": "female",
        "image": null
      }
    ]
  }
}

Response Fields

Field	Type	Description
`error`	boolean	Indicates if there was an error
`code`	integer	HTTP status code
`message`	string	Success or error message
`timestamp`	integer	Unix timestamp in milliseconds
`data`	object	Response data object
`data.provider_id`	string	Unique identifier for the provider
`data.provider_name`	string	Name of the voice provider
`data.total_count`	integer	Total number of available voices
`data.next_page_token`	string	Token for fetching the next page (null if no more pages)
`data.has_more`	boolean	Indicates if more voices are available
`data.voices`	array	Array of voice objects

Voice Object Fields

Field	Type	Description
`id`	string	Unique voice identifier (use this when creating agents)
`title`	string	Display name of the voice
`category`	string	Voice category (`professional`, `premade`, etc.)
`description`	string	Detailed description of the voice characteristics
`url`	string	Sample audio URL to preview the voice
`language`	string	Language code (e.g., `en`, `ta`, `ar`, `hi`)
`age`	string	Age category (`young`, `middle_aged`, `old`)
`gender`	string	Gender (`male`, `female`, `neutral`)
`image`	string	Profile image URL (may be null)

Error Responses

400 - Bad Request

Status Code: 400 Bad Request

{
  "error": true,
  "code": 400,
  "message": "Provider parameter is required",
  "data": {}
}

401 - Authentication Error

Status Code: 401 Unauthorized

{
  "error": true,
  "code": 401,
  "message": "Invalid Auth Key or Session Expired",
  "data": {}
}

404 - Provider Not Found

Status Code: 404 Not Found

{
  "error": true,
  "code": 404,
  "message": "Provider not found",
  "data": {}
}

500 - Server Error

Status Code: 500 Internal Server Error

{
  "error": true,
  "code": 500,
  "message": "Internal server error",
  "data": {}
}

Pagination

When has_more is true, use the next_page_token value in your next request to fetch the next page of voices:

curl -X GET "https://www.tryunleashx.com/api/voice-list?provider=elevenlabs&page_token=YOUR_NEXT_PAGE_TOKEN" \
  -H "token: YOUR_AUTH_TOKEN"

Supported Providers

Provider	ID	Description
ElevenLabs	`elevenlabs`	High-quality AI voices with emotional range
OpenAI	`openai`	OpenAI’s text-to-speech voices
Deepgram	`deepgram`	Fast, accurate voice synthesis
Sarvam	`sarvam`	Multilingual voices optimized for Indian languages

Usage Notes

Use the id field from the voice object when creating or updating agents with the voice_id parameter
Preview voices using the url field before selecting one for your agent
Filter voices by language, gender, or age in your application logic
The category field helps identify voice types (professional for business use, premade for general purpose)
Some providers may have rate limits on voice listing; implement caching when possible

Example: Using Voice ID in Agent Creation

After fetching voices, use the voice id when creating an agent:

curl -X POST "https://www.tryunleashx.com/api/agent/createagentorupdate" \
  -H "token: YOUR_AUTH_TOKEN" \
  -F "basic_details[agent_name]=My Agent" \
  -F "basic_details[voice_id]=s3I1dCXC0u6BYPeTyp1u" \
  -F "basic_details[voice_provider]=1"

Headers

token

string

required

API token for authentication

Query Parameters

provider_id

enum<string>

required

Voice provider identifier

Available options:

elevenlabs,

openai,

deepgram,

sarvam

page_token

string

Token for pagination to retrieve the next page of results

limit

integer

Number of voices to return per page

Response

error

boolean

code

integer

message

string

timestamp

integer

data

object

Show child attributes

API Documentation

Phone Numbers

Voice AI

Click to Call

Call Logs

Campaigns

Users

API Endpoint

Query Parameters

Response Fields

Voice Object Fields

Error Responses

400 - Bad Request

401 - Authentication Error

404 - Provider Not Found

500 - Server Error

Supported Providers

Usage Notes

Example: Using Voice ID in Agent Creation

Headers

Query Parameters

Response

​API Endpoint

​Query Parameters

​Response Fields

​Voice Object Fields

​Error Responses

​400 - Bad Request

​401 - Authentication Error

​404 - Provider Not Found

​500 - Server Error

​Pagination

​Supported Providers

​Usage Notes

​Example: Using Voice ID in Agent Creation

Headers

Query Parameters

Response

API Endpoint

Query Parameters

Response Fields

Voice Object Fields

Error Responses

400 - Bad Request

401 - Authentication Error

404 - Provider Not Found

500 - Server Error

Pagination

Supported Providers

Usage Notes

Example: Using Voice ID in Agent Creation