DeepL Web Translator Create Free API Account Contact Us

OpenAPI spec for glossary management

This page contains only a set of guides that is auto-generated from DeepL's OpenAPI file.

For more detail about glossary management, including information about request parameters, please see the Manage glossaries entry.

List supported glossary languages

Create a glossary

List all glossaries

Retrieve glossary details

Retrieve glossary entries

Delete a glossary

Last updated 6 months ago

List Language Pairs Supported by Glossaries

Retrieve the list of language pairs supported by the glossary feature.

GEThttps://api.deepl.com/v2/glossary-language-pairs

Authorization

Response

A JSON object containing the language pairs in its supported_languages property.

Body

supported_languagesarray of object

The list of supported languages

Response

{
  "supported_languages": [
    {
      "source_lang": "de",
      "target_lang": "en"
    },
    {
      "source_lang": "en",
      "target_lang": "de"
    }
  ]
}

Create a Glossary

POSThttps://api.deepl.com/v2/glossaries

Authorization

Body

name*string

Name to be associated with the glossary.

Example: "My Glossary"

source_lang*enum

The language in which the source texts in the glossary are specified.

Example: "en"

dadeenesfritjakonbnlplptrorusvzh

target_lang*enum

The language in which the target texts in the glossary are specified.

Example: "de"

dadeenesfritjakonbnlplptrorusvzh

entries*string

The entries of the glossary. The entries have to be specified in the format provided by the entries_format parameter.

Example: "Hello\tGuten Tag"

entries_format*enum

The format in which the glossary entries are provided. Formats currently available:

tsv (default) - tab-separated values
csv - comma-separated values

See Supported Glossary Formats for details about each format.

Example: "tsv"

tsvcsv

Response

The function for creating a glossary returns a JSON object containing the ID of the newly created glossary and a boolean flag that indicates if the created glossary can already be used in translate requests.

Body

glossary_idstring

A unique ID assigned to a glossary.

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

namestring

Name associated with the glossary.

readyboolean

Indicates if the newly created glossary can already be used in translate requests. If the created glossary is not yet ready, you have to wait and check the ready status of the glossary before using it in a translate request.

source_langenum

The language in which the source texts in the glossary are specified.

Example: "en"

dadeenesfritjakonbnlplptrorusvzh

target_langenum

The language in which the target texts in the glossary are specified.

Example: "de"

dadeenesfritjakonbnlplptrorusvzh

creation_timestring (date-time)

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

entry_countinteger

The number of entries in the glossary.

Response

{
  "glossary_id": "def3a26b-3e84-45b3-84ae-0c0aaf3525f7",
  "ready": true,
  "name": "My Glossary",
  "source_lang": "en",
  "target_lang": "de",
  "creation_time": "2021-08-03T14:16:18.329Z",
  "entry_count": 1
}

List all Glossaries

List all glossaries and their meta-information, but not the glossary entries.

GEThttps://api.deepl.com/v2/glossaries

Authorization

Response

JSON object containing a the glossaries.

Body

glossariesarray of object

Response

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

Retrieve Glossary Details

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

GEThttps://api.deepl.com/v2/glossaries/{glossary_id}

Authorization

Path parameters

glossary_id*string

A unique ID assigned to the glossary.

Response

JSON object containing the glossary meta-information.

Body

glossary_idstring

A unique ID assigned to a glossary.

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

namestring

Name associated with the glossary.

readyboolean

source_langenum

The language in which the source texts in the glossary are specified.

Example: "en"

dadeenesfritjakonbnlplptrorusvzh

target_langenum

The language in which the target texts in the glossary are specified.

Example: "de"

dadeenesfritjakonbnlplptrorusvzh

creation_timestring (date-time)

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

entry_countinteger

The number of entries in the glossary.

Response

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

Retrieve Glossary Entries

List the entries of a single glossary in the format specified by the Accept header.

GEThttps://api.deepl.com/v2/glossaries/{glossary_id}/entries

Authorization

Path parameters

glossary_id*string

A unique ID assigned to the glossary.

Header parameters

Response

The entries in the requested format.

Body

any

Response

Hello!	Guten Tag!

Delete a Glossary

Deletes the specified glossary.

DELETEhttps://api.deepl.com/v2/glossaries/{glossary_id}

Authorization

Path parameters

glossary_id*string

A unique ID assigned to the glossary.

Response

Returns no content upon success.

Response

{
  "message": "Invalid glossary entries provided",
  "detail": "Key with the index 1 (starting at position 13) duplicates key with the index 0 (starting at position 0)"
}