Retrieve glossary details

Retrieve meta information for a single glossary, omitting the glossary entries.

GET /v3/glossaries/{glossary_id}

Retrieve Glossary Details

cURL

curl --request GET \
  --url https://api.deepl.com/v3/glossaries/{glossary_id} \
  --header 'Authorization: <api-key>'

200

{
  "glossary_id": "def3a26b-3e84-45b3-84ae-0c0aaf3525f7",
  "name": "My Glossary",
  "dictionaries": [
    {
      "source_lang": "EN",
      "target_lang": "DE",
      "entry_count": 1
    },
    {
      "source_lang": "DE",
      "target_lang": "EN",
      "entry_count": 2
    }
  ],
  "creation_time": "2021-08-03T14:16:18.429Z"
}

Authorizations

Authorization · string · header · default: DeepL-Auth-Key · required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Path Parameters

glossary_id · string · required

A unique ID assigned to the glossary.

Response

200

application/json

JSON object containing the glossary meta-information.

glossary_id · string

A unique ID assigned to a glossary.

Example:

"def3a26b-3e84-45b3-84ae-0c0aaf3525f7"

name · string

Name associated with the glossary.

dictionaries · object[]

List of dictionaries contained in this glossary. Each dictionary contains a source and target language, as well as pairs of source and target entries.

Show child attributes

creation_time · string<date-time>

The creation time of the glossary in the ISO 8601-1:2019 format (e.g.: 2021-08-03T14:16:18.329Z).