# Retrieve Supported Languages

**GET /v2/languages**

Retrieve the list of languages that are currently supported for translation, either as source or target language, respectively.


## Servers
- DeepL API Pro: https://api.deepl.com (DeepL API Pro)
- DeepL API Free: https://api-free.deepl.com (DeepL API Free)


## Authentication methods
- Auth header


## Parameters


### Query parameters

- **type** (string)
  Sets whether source or target languages should be listed. Possible options are:
   * `source` (default): For languages that can be used in the `source_lang` parameter of [translate](https://www.deepl.com/docs-api/translate-text/translate-text) requests.
   * `target`: For languages that can be used in the `target_lang` parameter of [translate](https://www.deepl.com/docs-api/translate-text/translate-text) requests.



## Responses
### 200
JSON array where each item represents a supported language.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


#### Body: application/json (array[object])
- **language** (string)
  The language code of the given language.

- **name** (string)
  Name of the language in English.

- **supports_formality** (boolean)
  Denotes formality support in case of a target language listing.


### 400
Bad request. Please check error message and your parameters.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 403
Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 404
The requested resource could not be found.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 413
The request size exceeds the limit.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 429
Too many requests. Please wait and resend your request.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 456
Quota exceeded. The character limit has been reached.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 500
Internal error.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 504
Resource currently unavailable. Try again later.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 529
Too many requests. Please wait and resend your request.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.



[Powered by Bump.sh](https://bump.sh)