List Voices

GET

voices

List Voices

curl --request GET \
  --url https://api.dialnexa.com/v1/voices \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.dialnexa.com/v1/voices', 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://api.dialnexa.com/v1/voices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <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://api.dialnexa.com/v1/voices"

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

	req.Header.Add("Authorization", "Bearer <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://api.dialnexa.com/v1/voices")

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

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

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

[
  {
    "id": "voice_mfgt2k9x4q7w1z",
    "name": "Aditi",
    "gender": "female",
    "provider": "elevenlabs",
    "accent": "indian"
  }
]

Read only List voices available to the authenticated workspace, including the shared catalog and its imported voices. API-key responses are a root array containing id, name, gender, provider, and accent. Use id as the agent’s voice_id; use Get Voice Languages to inspect supported languages.

Filter Voices By All Selected Languages

Pass comma-separated language_ids to require support for every selected language. The existing language_id filter remains available for a single language. Obtain IDs from List Voice Language Options.

Parameter	Description
`language_ids`	Comma-separated language IDs; the voice must support all of them.
`language_id`	One language ID.
`gender`	`male`, `female`, or `non-binary`.
`provider`	Upstream provider filter. Availability can depend on the workspace.
`name`, `accent`	Narrow by voice name or accent.
`page`, `limit`	Page starts at 1. Limit defaults to 20; the maximum is 50, and a larger value returns `400`. A `provider`, `accent` or `gender` outside its list also returns `400`; that message does not list the allowed values, so use the values on this page.

Query parameters

Parameter	Description
`llm_id`	Filter voices compatible with a specific LLM ID (S2S models only).

Verify Available Voices

Choose a voice from this workspace’s current results before saving the agent. A private import from another workspace is not usable even if you know its ID. Voice listing does not change any settings and can be retried safely.

Errors

400 Bad Request is returned when page or limit is below 1 or not a whole number, limit is above 50, or a provider, accent or gender is outside its list.
401 Unauthorized is returned when the API key is missing or revoked.

Get Voice Details: detail for a single voice.
List Accents: accent filter dimension.
Text-to-speech and voices: guidance on choosing the right voice.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

provider

enum<string>

Filter by TTS provider

Available options:

elevenlabs,

smallestai,

sarvam,

cartesia,

soniox

accent

enum<string>

Accent of the voice

Available options:

indian,

british,

american,

canadian,

african,

australian,

swedish

gender

enum<string>

Gender of the voice

Available options:

male,

female,

non-binary

name

string

Search by voice name

Example:

"English"

page

number

default:1

Page number (starts from 1)

Required range: x >= 1

Example:

1

limit

number

default:20

Results per page. Default 20, maximum 50; a larger value returns 400.

Required range: 1 <= x <= 50

Example:

20

language_id

string

Filter voices that support a specific language ID

Example:

"lang_mfgsys4hhg8gdn"

llm_id

string

Filter voices compatible with a specific LLM ID (S2S models only)

Example:

"llm_mfgt5q2x8k4w7r"

language_ids

string

Comma-separated language IDs. The voice must support every selected language.

Response

Voices returned successfully.

string

name

string

gender

string

provider

string

accent

string | null

List Voices

curl --request GET \
  --url https://api.dialnexa.com/v1/voices \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.dialnexa.com/v1/voices', 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://api.dialnexa.com/v1/voices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <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://api.dialnexa.com/v1/voices"

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

	req.Header.Add("Authorization", "Bearer <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://api.dialnexa.com/v1/voices")

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

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

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

[
  {
    "id": "voice_mfgt2k9x4q7w1z",
    "name": "Aditi",
    "gender": "female",
    "provider": "elevenlabs",
    "accent": "indian"
  }
]

Overview

Endpoints

Filter Voices By All Selected Languages

Query parameters

Verify Available Voices

Errors

Authorizations

Query Parameters

Response

​Filter Voices By All Selected Languages

​Query parameters

​Verify Available Voices

​Errors

​Related endpoints

Authorizations

Query Parameters

Response

Filter Voices By All Selected Languages

Query parameters

Verify Available Voices

Errors

Related endpoints