> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gnani.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Languages

> Retrieve the list of supported languages for agent configuration

## 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

```bash theme={null}
curl "https://api.inya.ai/platform/v1/agents/config/languages" \
  -H "x-api-key: <your_api_key>"
```

## Response

### Success (200)

```json theme={null}
{
  "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

```json theme={null}
{
  "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

<Tip>
  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.
</Tip>

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

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


## OpenAPI

````yaml GET /v1/agents/config/languages
openapi: 3.0.3
info:
  title: Platform Agent Config API
  description: >-
    Read-only endpoints for discovering valid configuration values — languages,
    regions, timezones, LLM models, ASR providers, and TTS voices — before
    creating or updating agents.
  version: 2.1.0
servers:
  - url: https://api.inya.ai/platform
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: AgentConfiguration
    description: Agent configuration discovery operations
paths:
  /v1/agents/config/languages:
    get:
      tags:
        - AgentConfiguration
      summary: Get supported languages
      description: Retrieve all language codes supported by the platform.
      operationId: getLanguages
      responses:
        '200':
          description: Language data retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
              examples:
                success:
                  value:
                    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
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    StandardResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        requestId:
          type: string
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        message:
          type: string
        response:
          type: object
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          example: failure
        requestId:
          type: string
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        message:
          type: string
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    ServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key with 'agents' permission

````