# Retrieve Glossary Details

**GET /v2/glossaries/{glossary_id}**

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


## 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

### Path parameters

- **glossary_id** (string)
  A unique ID assigned to the glossary.




## Responses
### 200
JSON object containing the glossary meta-information.
#### Headers

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


#### Body: application/json (object)
- **glossary_id** (string)
  A unique ID assigned to a glossary.

- **name** (string)
  Name associated with the glossary.

- **ready** (boolean)
  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_lang** (string)
  The language in which the source texts in the glossary are specified.

- **target_lang** (string)
  The language in which the target texts in the glossary are specified.

- **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`).

- **entry_count** (integer)
  The number of entries in the glossary.


### 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.


#### Body: application/json (object)
- **message** (string)
  Generic description of the error.

- **detail** (string)
  More specific description of the error.


### 401
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.


### 403
Forbidden. The access to the requested resource is denied, because of insufficient access rights.
#### 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.


### 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.


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

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


### 503
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)