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

# GET /languages

> List all supported transcription languages

## Endpoint

```
GET https://lyrcs.ai/api/v1/languages
```

**No authentication required.** Returns the complete list of supported languages with name and language family.

## Response

```json theme={null}
{
  "languages": [
    { "name": "Hindi", "family": "Indo-Aryan" },
    { "name": "Tamil", "family": "Dravidian" }
  ],
  "total": 48
}
```

## Using language values

The `name` field is the value to pass as `language` in `POST /transcribe` and `POST /batch`.

<Warning>
  Language values are **case-sensitive**. `"Tamil"` is accepted. `"tamil"` and `"TAMIL"` both return `400 validation_error`. Always use the exact strings from this endpoint.
</Warning>

## Full language reference

### Indian Languages — 30

| Language      | Family        |
| ------------- | ------------- |
| Hindi         | Indo-Aryan    |
| Bengali       | Indo-Aryan    |
| Marathi       | Indo-Aryan    |
| Telugu        | Dravidian     |
| Tamil         | Dravidian     |
| Gujarati      | Indo-Aryan    |
| Urdu          | Indo-Aryan    |
| Kannada       | Dravidian     |
| Odia          | Indo-Aryan    |
| Malayalam     | Dravidian     |
| Punjabi       | Indo-Aryan    |
| Assamese      | Indo-Aryan    |
| Maithili      | Indo-Aryan    |
| Santali       | Austroasiatic |
| Kashmiri      | Indo-Aryan    |
| Nepali        | Indo-Aryan    |
| Sindhi        | Indo-Aryan    |
| Konkani       | Indo-Aryan    |
| Dogri         | Indo-Aryan    |
| Manipuri      | Sino-Tibetan  |
| Bodo          | Sino-Tibetan  |
| Sanskrit      | Indo-Aryan    |
| Haryanvi      | Indo-Aryan    |
| Bhojpuri      | Indo-Aryan    |
| Magahi        | Indo-Aryan    |
| Chhattisgarhi | Indo-Aryan    |
| Rajasthani    | Indo-Aryan    |
| Tulu          | Dravidian     |
| Gondi         | Dravidian     |
| Saurashtra    | Indo-Aryan    |

### Global Languages — 18

| Language         | Family       |
| ---------------- | ------------ |
| English          | Germanic     |
| Spanish          | Romance      |
| Mandarin Chinese | Sino-Tibetan |
| French           | Romance      |
| Arabic           | Semitic      |
| Portuguese       | Romance      |
| Russian          | Slavic       |
| Japanese         | Japonic      |
| German           | Germanic     |
| Korean           | Koreanic     |
| Italian          | Romance      |
| Turkish          | Turkic       |
| Dutch            | Germanic     |
| Indonesian       | Austronesian |
| Thai             | Tai-Kadai    |
| Yoruba           | Niger-Congo  |
| Swahili          | Niger-Congo  |
| Zulu             | Niger-Congo  |

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl https://lyrcs.ai/api/v1/languages
  ```

  ```javascript Node.js theme={null}
  const res = await fetch("https://lyrcs.ai/api/v1/languages");
  const { languages } = await res.json();

  // Get all Indian language names
  const indianLangs = languages
    .filter((l) => ["Indo-Aryan", "Dravidian", "Austroasiatic", "Sino-Tibetan"].includes(l.family))
    .map((l) => l.name);
  ```

  ```python Python theme={null}
  import requests

  r = requests.get("https://lyrcs.ai/api/v1/languages")
  languages = r.json()["languages"]

  # Get all language names as a set for validation
  valid_languages = {lang["name"] for lang in languages}
  ```
</CodeGroup>