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

# Get Languages

> Returns the languages available to your project, including whether each locale supports dubbing, voice cloning, and text or document translation.

## Description

Use this endpoint before uploading media or calling translate APIs so you only request locales the platform can process.

**URL variants (same handler):**

* `GET /v2/languages` and `GET /v2/languages/` — unfiltered list; `request_type` is `all`.
* `GET /v2/languages/{language_type}` — filter by capability; see [Get Languages (filtered)](/vod/get-languages-by-type) for the interactive reference and `language_type` values `dubbing`, `text`, or `all`.

**Filters:**

| Path segment | Meaning                                                              |
| ------------ | -------------------------------------------------------------------- |
| `all`        | Every configured language (same as the bare `/v2/languages` routes). |
| `dubbing`    | Languages available for video dubbing.                               |
| `text`       | Languages available for document and text translation.               |

## Endpoint URL

```http theme={null}
GET https://api.lingopal.ai/v2/languages/
```

## Parameters

| Location | Name            | Type   | Required | Description                                                                                        |
| -------- | --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------- |
| Path     | `language_type` | string | No       | Omit by calling `/v2/languages/` or use one of `dubbing`, `text`, `all` as the final path segment. |

## Response

### Success (200)

`Content-Type: application/json`

```json theme={null}
{
  "request_type": "all",
  "count": 2,
  "languages": [
    {
      "locale": "en-US",
      "language": "English",
      "dubbing_support": true,
      "voice_cloning_support": true,
      "text_support": true,
      "language_id": 1
    },
    {
      "locale": "es-US",
      "language": "Spanish",
      "dubbing_support": true,
      "voice_cloning_support": false,
      "text_support": true,
      "language_id": 2
    }
  ]
}
```

### Response fields

| Field                               | Type    | Description                                              |
| ----------------------------------- | ------- | -------------------------------------------------------- |
| `request_type`                      | string  | Echo of the applied filter: `dubbing`, `text`, or `all`. |
| `count`                             | integer | Number of entries in `languages`.                        |
| `languages`                         | array   | List of language records.                                |
| `languages[].locale`                | string  | Locale code for the language.                            |
| `languages[].language`              | string  | Display name of the language.                            |
| `languages[].dubbing_support`       | boolean | Whether video dubbing is supported for this locale.      |
| `languages[].voice_cloning_support` | boolean | Whether voice cloning is supported for this locale.      |
| `languages[].text_support`          | boolean | Whether text or document translation is supported.       |
| `languages[].language_id`           | integer | Internal identifier for the language.                    |

## Example requests

All languages:

```bash theme={null}
curl -sS -X GET "https://api.lingopal.ai/v2/languages/" \
  -H "Accept: application/json"
```

Dubbing-capable languages only:

```bash theme={null}
curl -sS -X GET "https://api.lingopal.ai/v2/languages/dubbing" \
  -H "Accept: application/json"
```

## Error responses

### 500 Internal Server Error

```json theme={null}
{
  "detail": "Internal Server Error"
}
```

## Next steps

* [Upload Video](/vod/upload-video) — upload media with target locales
* [Translate Text](/vod/translate-text) — translate text into selected languages