List Languages

Retrieve every language DialNexa supports for agents, transcription, and voice synthesis, including BCP-47 codes.

GET /languages

List languages

cURL

curl --request GET \
  --url https://api.dialnexa.com/v1/languages \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "lang_en_us",
      "name": "English",
      "code": "en-US",
      "is_supported_for_transcription": true
    }
  ]
}

Returns every language DialNexa supports for agent prompts, speech-to-text transcription, and text-to-speech synthesis. Each entry 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 in that language. Use this endpoint as the canonical source of truth for what the platform currently supports, language coverage evolves as providers add new models.

When to use this

• Agent build UIs: populate the language dropdown when creating or editing an agent.
• Validation pipelines: confirm a language is still supported before publishing an agent change.
• Multi-region rollouts: discover which languages have voice coverage in a given region.
• Internationalization audits: verify your DialNexa deployment supports every language your customer base speaks.

For a single record, use Get Language.

Response shape

Each language returns at least:

• id: the stable internal identifier (for example lang_en_in).
• code: the BCP-47 language code, suitable for tagging text-to-speech output and matching to transcriber configuration.
• name: a human-readable display label.
• voices (when present): the voices currently available in that language.

Errors

• 401 Unauthorized is returned when the API key is missing or revoked.

Request

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

Response

{
  "data": [
    { "id": "lang_en_in", "name": "English (India)", "code": "en-IN" },
    { "id": "lang_en_us", "name": "English (US)",    "code": "en-US" },
    { "id": "lang_hi_in", "name": "Hindi",           "code": "hi-IN" }
  ]
}

Related endpoints

• Get Language: fetch a single language.
• List Voices: browse voices filterable by language.
• List Transcribers: pick a transcriber that supports the chosen language.
• Multilingual and Hinglish calls: guidance for mixed-language deployments.

Authorizations

Authorization · string · header · required

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

Response

200 - application/json

Success.

data · object[]

Show child attributes