Get Voice Details

GET

voices

{id}

Get Voice Details

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

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

fetch('https://api.dialnexa.com/v1/voices/{id}', 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/{id}",
  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/{id}"

	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/{id}")

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_abc123",
  "name": "Aditi",
  "provider": "elevenlabs",
  "language_code": "en-IN",
  "gender": "female",
  "preview_url": "https://example.com/preview.mp3"
}

{
  "statusCode": 400,
  "message": "Invalid catalog ID format",
  "error": "Bad Request"
}

{
  "statusCode": 401,
  "message": "API key is missing or invalid",
  "error": "Unauthorized"
}

{
  "statusCode": 403,
  "message": "You do not have permission to access this resource",
  "error": "Forbidden"
}

{
  "statusCode": 404,
  "message": "Voice not found",
  "error": "Not Found"
}

{
  "statusCode": 500,
  "message": "Internal server error",
  "error": "Internal Server Error"
}

Read only Returns the full record for a single text-to-speech voice supported by DialNexa: the display name, the primary language_code (BCP-47), the perceived gender, the default model_id, the upstream provider, and a preview_url you can play to sample the voice.

When to use this

Voice picker UIs: render the selected voice with its preview audio and provider badge when editing an agent.
Agent configuration validation: confirm the saved voice still exists and supports the language the agent is set to before publishing changes.
Migration tooling: when a provider deprecates a voice, look up replacements by language and gender.

For the full catalogue, use List Voices. The catalogue is paginated and supports filtering by language.

Path parameters

Parameter	Description
`id`	The voice ID, for example `vce_en_us_ava`.

Errors

404 Not Found is returned when the voice does not exist or has been removed by the provider.
401 Unauthorized is returned when the API key is missing or revoked.

List Voices: search and filter all available voices.
List Accents: see available accent options across voices.
Text-to-speech and voices: guidance on choosing a voice.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Voice ID

Example:

"voice_abc123"

Response

Voice returned successfully.

string

Example:

"voice_abc123"

name

string

provider

string

gender

string

accent

string

Get Voice Details

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

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

fetch('https://api.dialnexa.com/v1/voices/{id}', 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/{id}",
  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/{id}"

	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/{id}")

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_abc123",
  "name": "Aditi",
  "provider": "elevenlabs",
  "language_code": "en-IN",
  "gender": "female",
  "preview_url": "https://example.com/preview.mp3"
}

{
  "statusCode": 400,
  "message": "Invalid catalog ID format",
  "error": "Bad Request"
}

{
  "statusCode": 401,
  "message": "API key is missing or invalid",
  "error": "Unauthorized"
}

{
  "statusCode": 403,
  "message": "You do not have permission to access this resource",
  "error": "Forbidden"
}

{
  "statusCode": 404,
  "message": "Voice not found",
  "error": "Not Found"
}

{
  "statusCode": 500,
  "message": "Internal server error",
  "error": "Internal Server Error"
}

Overview

Endpoints

Code Examples And SDK Status

When to use this

Path parameters

Errors

Authorizations

Path Parameters

Response

​When to use this

​Path parameters

​Errors

​Related endpoints

Authorizations

Path Parameters

Response

When to use this

Path parameters

Errors

Related endpoints