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

ParameterDescription
idThe language ID, for example lang_en_in.

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"