Skip to main content
GET
/
voices
/
{id}
Get a voice
curl --request GET \
  --url https://api.dialnexa.com/v1/voices/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "voice_xyz",
  "name": "Aria",
  "gender": "female",
  "language_code": "en-US",
  "provider": "elevenlabs",
  "preview_url": "https://voices.dialnexa.com/aria_preview.mp3"
}
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. Use List Voice Models to see all model variants available for this voice, different variants trade latency, naturalness, and cost.

​
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

ParameterDescription
idThe 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.

​
Request

curl "https://api.dialnexa.com/v1/voices/vce_en_us_ava" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "id": "vce_en_us_ava",
  "name": "Ava",
  "language_code": "en-US",
  "gender": "female",
  "model_id": "eleven_multilingual_v2",
  "provider": "elevenlabs",
  "preview_url": "https://storage.dialnexa.com/voice-previews/vce_en_us_ava.mp3"
}

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token in the Authorization header.

Path Parameters

​
id
string
required

Response

Success.

​
id
string
Example:

"voice_xyz"

​
name
string
Example:

"Aria"

​
gender
string
Example:

"female"

​
language_code
string
Example:

"en-US"

​
provider
string
Example:

"elevenlabs"

​
preview_url
string
Example:

"https://voices.dialnexa.com/aria_preview.mp3"