Voices
Get Voice Details
Fetch one voice catalog entry by ID.
GET
Get Voice Details
Read only
Returns the full record for a single text-to-speech voice supported by DialNexa: the display
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.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.
Path parameters
Errors
404 Not Foundis returned when the voice does not exist or has been removed by the provider.401 Unauthorizedis returned when the API key is missing or revoked.
Related endpoints
- List Voices: search and filter all available voices.
- List Voice Models: see model variants for a given voice.
- List Accents: see available accent options across voices.
- Text-to-speech and voices: guidance on choosing a voice.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Voice ID
Example:
"voice_abc123"
Get Voice Details