Get supported languages
curl --request GET \
--url https://api.inya.ai/platform/v1/agents/config/languages \
--header 'x-api-key: <api-key>'import requests
url = "https://api.inya.ai/platform/v1/agents/config/languages"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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>"
}Agent Config API
Get Languages
Retrieve the list of supported languages for agent configuration
GET
/
v1
/
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>'import requests
url = "https://api.inya.ai/platform/v1/agents/config/languages"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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>"
}What it does: Retrieve the full list of languages supported by the Agent Builder 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
Minimum working example
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. |
Errors
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 Gnani support to trace a specific request.Was this page helpful?