Skip to main content
GET
Get Language 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 language supported by DialNexa. The response includes the language’s stable id, its BCP-47 code (for example en-IN, hi-IN, en-US), the human-readable display name, and the set of voices available for that language.

When to use this

Use this endpoint when you have a language id saved in your own database, on an agent configuration, or in a workflow node, and you need to resolve it to its display name, BCP-47 code, or available voice list. Common cases include:
  • Agent configuration UIs that render the selected language for a saved agent and need to show its proper name and accent options.
  • Audit and reporting tools that translate an internal language ID into a localized label for dashboards.
  • Provisioning flows that validate a language is still supported on the platform before sending an agent update through Update Agent.
If you need the entire catalogue rather than a single record, use List Languages instead. The result of that endpoint is paginated and is the canonical source of truth for what DialNexa currently supports.

Path parameters

Errors

  • 404 Not Found is returned when the id does not match any supported language. This usually means the language has been removed from the platform or the ID was mistyped.
  • 401 Unauthorized is returned when the API key is missing, malformed, or has been revoked. See Authentication.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Language ID

Example:

"lang_abc123"

Response

Language returned successfully.

id
string
required

Signed language ID

Example:

"lang_abc123"