Get Languages

Get supported languages

curl --request GET \
  --url https://api.inya.ai/platform/v1/agents/config/languages \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.inya.ai/platform/v1/agents/config/languages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Language data retrieved successfully",
  "response": {
    "languages": [
      {
        "langId": "en-IN",
        "name": "English (IN)",
        "pair": [
          {
            "langId": "hi-IN"
          },
          {
            "langId": "kn-IN"
          },
          {
            "langId": "ta-IN"
          },
          {
            "langId": "te-IN"
          }
        ]
      },
      {
        "langId": "hi-IN",
        "name": "Hindi",
        "pair": [
          {
            "langId": "en-IN"
          },
          {
            "langId": "kn-IN"
          },
          {
            "langId": "ta-IN"
          }
        ]
      },
      {
        "langId": "ta-IN",
        "name": "Tamil",
        "pair": [
          {
            "langId": "hi-IN"
          },
          {
            "langId": "en-IN"
          }
        ]
      }
    ]
  }
}

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

GET

agents

config

languages

Get supported languages

curl --request GET \
  --url https://api.inya.ai/platform/v1/agents/config/languages \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.inya.ai/platform/v1/agents/config/languages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Language data retrieved successfully",
  "response": {
    "languages": [
      {
        "langId": "en-IN",
        "name": "English (IN)",
        "pair": [
          {
            "langId": "hi-IN"
          },
          {
            "langId": "kn-IN"
          },
          {
            "langId": "ta-IN"
          },
          {
            "langId": "te-IN"
          }
        ]
      },
      {
        "langId": "hi-IN",
        "name": "Hindi",
        "pair": [
          {
            "langId": "en-IN"
          },
          {
            "langId": "kn-IN"
          },
          {
            "langId": "ta-IN"
          }
        ]
      },
      {
        "langId": "ta-IN",
        "name": "Tamil",
        "pair": [
          {
            "langId": "hi-IN"
          },
          {
            "langId": "en-IN"
          }
        ]
      }
    ]
  }
}

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

Overview

Retrieve the full list of languages supported by the Inya platform. The returned language codes follow the BCP-47 standard (e.g. en-IN, hi-IN) and are used across all other configuration endpoints — including Get Transcriber Config and Get TTS Config — to discover compatible providers for your target languages.

Required Permission

agents

Example cURL

curl "https://api.inya.ai/platform/v1/agents/config/languages" \
  -H "x-api-key: <your_api_key>"

Response

Success (200)

{
  "status": "success",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Language data retrieved successfully",
  "response": {
    "languages": [
      {
        "langId": "en-IN",
        "name": "English (IN)",
        "pair": [
          { "langId": "hi-IN" },
          { "langId": "kn-IN" },
          { "langId": "ta-IN" },
          { "langId": "te-IN" }
        ]
      },
      {
        "langId": "hi-IN",
        "name": "Hindi",
        "pair": [
          { "langId": "en-IN" },
          { "langId": "kn-IN" },
          { "langId": "ta-IN" }
        ]
      },
      {
        "langId": "ta-IN",
        "name": "Tamil",
        "pair": [
          { "langId": "hi-IN" },
          { "langId": "en-IN" }
        ]
      },
      {
        "langId": "te-IN",
        "name": "Telugu",
        "pair": [
          { "langId": "hi-IN" },
          { "langId": "en-IN" }
        ]
      },
      {
        "langId": "kn-IN",
        "name": "Kannada",
        "pair": [
          { "langId": "hi-IN" },
          { "langId": "en-IN" }
        ]
      }
    ]
  }
}

Response Fields

Field	Type	Description
`langId`	string	BCP-47 language code. Use this value in `botDetails.language[]` and as the `language` query parameter for transcriber and TTS config lookups.
`name`	string	Human-readable display name of the language.
`pair`	object[]	List of language codes that can be paired with this language for multilingual agents. Each object contains a `langId` field.

Error Responses

404 Not Found - Language configuration unavailable

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Language configuration not found"
}

Use Cases

Populating a language dropdown when creating or updating an agent
Passing language codes to Get Transcriber Config and Get TTS Config to filter compatible providers
Displaying supported languages in a settings UI or documentation

Language codes returned here (e.g. en-IN) are the exact values expected by the language query parameter in Get Transcriber Config and Get TTS Config. Use them directly to filter compatible providers and voices.

The supported language list grows over time. Always fetch this endpoint dynamically rather than hardcoding language codes in your application.

Save the requestId from every response. You will need it if you contact Inya support to trace a specific request.

Authorizations

x-api-key

string

header

required

API key with 'agents' permission

Response

Language data retrieved successfully

status

string

Example:

"success"

requestId

string

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

message

string

response

object

Getting Started

Agents API

Conversations API

Agent Config API

Agent FAQ API

Chat SDK API

Reference

Overview

Required Permission

Example cURL

Response

Success (200)

Response Fields

Error Responses

Use Cases

Authorizations

Response

​Overview

​Required Permission

​Example cURL

​Response

​Success (200)

​Response Fields

​Error Responses

​Use Cases

Authorizations

Response

Overview

Required Permission

Example cURL

Response

Success (200)

Response Fields

Error Responses

Use Cases