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

# List Languages

> List languages supported by DialNexa.

<span data-api-safety-label="read-only"><Badge color="gray" size="sm" shape="pill">Read only</Badge></span>

<Info>
  **Recommended.** This endpoint is part of the public `/v1` API reference and is the supported path for new integrations. See the [migration guide](/docs/api-reference/v1/migrating-to-v1) for versioning guidance.
</Info>

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 Details](/docs/api-reference/v1/languages/get).

## Errors

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

## Related endpoints

* [Get Language Details](/docs/api-reference/v1/languages/get): fetch a single language.
* [List Voices](/docs/api-reference/v1/voices/list): browse voices filterable by language.
* [List Transcribers](/docs/api-reference/v1/transcribers/list): pick a transcriber that supports the chosen language.
* [Multilingual and Hinglish calls](/docs/voice-ai/multilingual-and-hinglish-calls): guidance for mixed-language deployments.


## OpenAPI

````yaml GET /v1/languages
openapi: 3.0.0
info:
  title: DialNexa API
  description: >-
    Public REST API for the DialNexa voice AI platform. Versioned endpoints are
    under /v1; unversioned endpoints are legacy and deprecated.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: API Keys
  - name: Agent Functions
  - name: Agents V1
  - name: Agents2
  - name: Batch Calls
  - name: Batch Calls V1
  - name: Call Logs
  - name: Calls
  - name: Calls V1
  - name: Campaign Leads
  - name: Campaigns
  - name: External Webhooks
  - name: Knowledge Base
  - name: Knowledge Base V1
  - name: LLMs
  - name: LLMs V1
  - name: Languages
  - name: Languages V1
  - name: Organization Phone Numbers
  - name: Organization Phone Numbers V1
  - name: Phone Number Pricing
  - name: Phone Number Pricing V1
  - name: Transcribers
  - name: Transcribers V1
  - name: User Webhooks
  - name: User Webhooks V1
  - name: V1
  - name: Voices
  - name: Voices V1
  - name: Webcall
  - name: Workflow Leads
  - name: Workflow Leads V1
  - name: Workflows
  - name: Workflows V1
paths:
  /v1/languages:
    get:
      tags:
        - Languages V1
        - V1
      summary: List Languages
      description: >-
        Returns the complete catalog of languages available for agent
        configuration.
      operationId: LanguagesV1Controller_findAll
      parameters: []
      responses:
        '200':
          description: Languages returned successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Languages'
              examples:
                success:
                  summary: Successful response
                  value:
                    - id: lang_en_in
                      name: English (India)
                      code: en-IN
        '401':
          description: Unauthorized - missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: 401 Unauthorized
                  value:
                    statusCode: 401
                    message: API key is missing or invalid
                    error: Unauthorized
        '403':
          description: Forbidden - API key does not have access to this organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: 403 Forbidden
                  value:
                    statusCode: 403
                    message: You do not have permission to access this resource
                    error: Forbidden
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: 500 Internal Server Error
                  value:
                    statusCode: 500
                    message: Internal server error
                    error: Internal Server Error
      security:
        - bearer: []
components:
  schemas:
    Languages:
      type: object
      properties:
        id:
          type: string
          example: lang_abc123
          description: Signed language ID
      required:
        - id
    ErrorResponse:
      type: object
      properties:
        statusCode:
          type: integer
          example: 400
        message:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: phone_number must be a valid E.164 phone number
        error:
          type: string
          example: Bad Request
      required:
        - statusCode
        - message
        - error
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````