> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lister les unités

> Parcourir le catalogue des unités de mesure

Renvoie le catalogue des unités de mesure. L'`id` numérique reste stable en cas de renommage — stocke-le lorsque tu enregistres des données de résultats afin de pouvoir actualiser les titres d'affichage sans rompre l'intégrité référentielle.

Nécessite le scope `panels_access`.

Tu recevras des références `unit_id` dans les payloads de résultats ([Récupérer les résultats](https://docs.anivahealth.com/fr/api/appointments/get-results.md)) et sur l'unité par défaut de chaque biomarqueur ([Lister les biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md)). Utilise cet endpoint pour résoudre ces identifiants vers leur titre d'affichage actuel.

## Réponse

Renvoie un tableau d'unités.

**id** `number`

Identifiant stable de l'unité de mesure.

**title** `string`

Titre canonique de l'unité (par ex. `nmol/L`).

**display\_title** `string | null`

Surcharge d'affichage lisible facultative. `null` signifie qu'aucune surcharge n'existe — affiche `title` tel quel. Renseigné uniquement
lorsque le `title` canonique (qui privilégie l'analyse automatique) diffère de la
forme souhaitée pour l'interface (par ex. `ug/dL` → `µg/dL`).

**aliases** `string[]`

Orthographes alternatives et synonymes reconnus pour cette unité (par ex. `["mmol/l", "millimol/L"]`).
Exclut le `title` canonique. Utile pour faire correspondre des chaînes d'unités en texte libre issues de sources externes.

**unit\_type** `"physical" | "discrete" | "logarithmic"`

`physical` pour les grandeurs mesurables (par ex. `nmol/L`, `mg`). `discrete` pour les valeurs énumérées/catégorielles
(par ex. positif/négatif). `logarithmic` pour le logarithme d'une grandeur, comme le pH ou un
indice athérogène : la valeur n'a pas d'échelle linéaire.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `403` | Interdit — scope `panels_access` manquant. |
| `500` | Erreur interne du serveur. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/units' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
[
  {
    "id": 1,
    "title": "nmol/L",
    "display_title": null,
    "aliases": ["nmol/l"],
    "unit_type": "physical"
  },
  {
    "id": 2,
    "title": "mmol/L",
    "display_title": null,
    "aliases": ["mmol/l", "millimol/L"],
    "unit_type": "physical"
  },
  {
    "id": 47,
    "title": "ug/dL",
    "display_title": "µg/dL",
    "aliases": ["µg/dL", "mcg/dL"],
    "unit_type": "physical"
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.