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

# Elenca unità

> Sfoglia il catalogo delle unità di misura

Restituisce il catalogo delle unità di misura. L'`id` numerico resta stabile anche se il nome cambia — salvalo quando archivi i dati dei risultati, così i titoli visualizzati possono essere aggiornati senza compromettere l'integrità referenziale.

Richiede lo scope `panels_access`.

Riceverai i riferimenti `unit_id` nei payload dei risultati ([Ottieni risultati](https://docs.anivahealth.com/it/api/appointments/get-results.md)) e sull'unità predefinita di ciascun biomarcatore ([Elenca biomarcatori](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md)). Usa questo endpoint per risolvere quegli ID nel titolo visualizzato attuale.

## Risposta

Restituisce un array di unità.

**id** `number`

Identificatore stabile dell'unità di misura.

**title** `string`

Titolo canonico dell'unità (ad es. `nmol/L`).

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

Override opzionale per una visualizzazione leggibile. `null` indica che non esiste alcun override — mostra `title` così com'è. Popolato solo
quando il `title` canonico (che privilegia la leggibilità automatica) differisce dalla
forma preferita per la UI (ad es. `ug/dL` → `µg/dL`).

**aliases** `string[]`

Grafie alternative e sinonimi riconosciuti per questa unità (ad es. `["mmol/l", "millimol/L"]`).
Esclude il `title` canonico. Utile per far corrispondere stringhe di unità in testo libero da fonti esterne.

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

`physical` per grandezze misurabili (ad es. `nmol/L`, `mg`). `discrete` per valori enumerati o categorici
(ad es. positivo/negativo). `logarithmic` per il logaritmo di una grandezza, come il pH o un
indice aterogenico: il valore non ha una scala lineare.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `403` | Vietato — scope `panels_access` mancante. |
| `500` | Errore interno del server. |

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