---
title: "Retrieve Languages"
method: GET
path: "/v3/languages"
tags: ["MetaInformation"]
---

# Retrieve Languages

`GET /v3/languages`

Returns languages supported by the specified DeepL API resource. Each language indicates whether it can
be used as a source language, a target language, or both, along with the features it supports for that
resource.

## Query parameters

- `resource` 'translate_text' | 'translate_document' | 'glossary' | 'voice' | 'write' | 'style_rules' | 'translation_memory', required
- `include` string[]

## Response `200`

JSON array where each item represents a supported language.

- object[]
  - `lang` string, required — The language code (BCP 47).
  - `name` string, required — Name of the language in English.
  - `usable_as_source` boolean, required — Whether this language can be used as a source language with the specified resource.
  - `usable_as_target` boolean, required — Whether this language can be used as a target language with the specified resource.
  - `status` 'stable' | 'beta' | 'early_access', required — Availability status of this language.
  - `features` object, required — Features supported for this language with the specified resource. Always present; empty object if no optional features are supported. Each key is a feature name; the value is an object with at least a `status` field. Consult `GET /v3/languages/resources` to determine whether a feature must be present on the source language, target language, or both for a given resource.

## Other responses

- `400` — Bad request. Please check error message and your parameters.
- `401` — Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
- `403` — Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header. This error is also returned when the API key is scoped but does not include the scope required for this endpoint.
- `429` — Too many requests. Please wait and resend your request.
- `500` — Internal error.
- `503` — Resource currently unavailable. Try again later.

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) · [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deepl/deepl-api-documentation/revisions/3c422fcc9c54/schema)