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

# Einheiten auflisten

> Den Katalog der Maßeinheiten durchsuchen

Gibt den Katalog der Maßeinheiten zurück. Die numerische `id` bleibt auch bei Umbenennungen stabil – speichere sie, wenn du Ergebnisdaten speicherst, damit Anzeigetitel aktualisiert werden können, ohne die referenzielle Integrität zu verletzen.

Erfordert den Scope `panels_access`.

Du erhältst `unit_id`-Referenzen in Ergebnis-Payloads ([Ergebnisse abrufen](https://docs.anivahealth.com/de/api/appointments/get-results.md)) und bei der Standardeinheit jedes Biomarkers ([Biomarker auflisten](https://docs.anivahealth.com/de/api/biomarkers/list-biomarkers.md)). Nutze diesen Endpunkt, um diese IDs in einen aktuellen Anzeigetitel aufzulösen.

## Antwort

Gibt ein Array von Einheiten zurück.

**id** `number`

Stabile Kennung der Maßeinheit.

**title** `string`

Kanonischer Einheitentitel (z. B. `nmol/L`).

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

Optionale, lesefreundliche Anzeige-Überschreibung. `null` bedeutet, es gibt keine Überschreibung – stelle `title` unverändert dar. Wird nur
befüllt, wenn der kanonische `title` (der auf Maschinenlesbarkeit ausgelegt ist) von der
bevorzugten UI-Form abweicht (z. B. `ug/dL` → `µg/dL`).

**aliases** `string[]`

Alternative Schreibweisen und Synonyme, die für diese Einheit erkannt werden (z. B. `["mmol/l", "millimol/L"]`).
Enthält nicht den kanonischen `title`. Nützlich zum Abgleichen von Freitext-Einheiten aus externen Quellen.

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

`physical` für messbare Größen (z. B. `nmol/L`, `mg`). `discrete` für aufgezählte/kategoriale
Werte (z. B. positiv/negativ). `logarithmic` für den Logarithmus einer Größe, wie pH oder ein
atherogener Index: Der Wert hat keine lineare Skala.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `403` | Zugriff verweigert – fehlender Scope `panels_access`. |
| `500` | Interner Serverfehler. |

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