Skip to main content
GET
Get Voice Details
Read only
Recommended. This endpoint is part of the public /v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.
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

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.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Voice ID

Example:

"voice_abc123"

Response

Voice returned successfully.

id
string
Example:

"voice_abc123"

name
string
provider
string
gender
string
accent
string