> ## Documentation Index
> Fetch the complete documentation index at: https://api-doc.fidly.be/llms.txt
> Use this file to discover all available pages before exploring further.

# Listes de référence

> Unités, devises et pays : remplir un document ou une adresse sans rien coder en dur.

Trois listes en lecture seule fournissent tous les codes qu'un document ou une
adresse peut porter. Elles exigent un `access_token` valide mais **aucun droit de
ressource**, et sont identiques en sandbox et en live.

`language` est un paramètre de query **obligatoire** (`fr`, `en`, `nl`, `de`) : il
choisit la langue des libellés renvoyés. Une langue inconnue renvoie
`400 invalid_filter` ; une langue absente, `422 validation_error`.

| Endpoint                            | Renvoie                 | Traduit            |
| ----------------------------------- | ----------------------- | ------------------ |
| `GET /units-of-measure?language=fr` | `{code, symbol, label}` | symbole et libellé |
| `GET /currencies?language=fr`       | `{code, symbol, label}` | libellé seulement  |
| `GET /countries?language=fr`        | `{code, label}`         | libellé            |

## Garanties

Une liste ne propose jamais un code que l'API refuserait ensuite, et ne cache
jamais un code accepté. La validation de `unit_code`, `currency` et
`country_code` à l'écriture s'appuie sur les mêmes données que ces listes.

### Unités

Seules les unités **actives** sont listées, mais une unité retirée reste
acceptée à la création d'un document.

### Pays

L'ensemble est la code list Peppol, basée sur la norme ISO 3166-1 alpha-2. Une
poignée de codes acceptés n'ont pas encore de traduction et sortent avec
`label: null`.