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

# Llista les unitats

> Explora el catàleg d'unitats de mesura

Retorna el catàleg d'unitats de mesura. L'`id` numèric es manté estable tot i els canvis de nom — desa'l quan emmagatzemis dades de resultats per poder actualitzar els títols mostrats sense trencar la integritat referencial.

Requereix l'àmbit `panels_access`.

Rebràs referències `unit_id` a les càrregues útils de resultats ([Obtén els resultats](https://docs.anivahealth.com/ca/api/appointments/get-results.md)) i a la unitat predeterminada de cada biomarcador ([Llista els biomarcadors](https://docs.anivahealth.com/ca/api/biomarkers/list-biomarkers.md)). Fes servir aquest punt final per resoldre aquests identificadors en un títol mostrat actual.

## Resposta

Retorna una matriu d'unitats.

**id** `number`

Identificador estable de la unitat de mesura.

**title** `string`

Títol canònic de la unitat (p. ex., `nmol/L`).

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

Substitució opcional de visualització llegible. `null` indica que no hi ha cap substitució — mostra `title` tal qual. Només
s'omple quan el `title` canònic (que prioritza el processament automàtic) difereix de la
forma preferida a la interfície (p. ex., `ug/dL` → `µg/dL`).

**aliases** `string[]`

Grafies alternatives i sinònims reconeguts per a aquesta unitat (p. ex., `["mmol/l", "millimol/L"]`).
Exclou el `title` canònic. Útil per fer coincidir cadenes de text lliure d'unitats de fonts externes.

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

`physical` per a magnituds mesurables (p. ex., `nmol/L`, `mg`). `discrete` per a valors enumerats o categòrics
(p. ex., positiu/negatiu). `logarithmic` per al logaritme d'una magnitud, com ara el pH o un
índex aterogènic: el valor no té una escala lineal.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `403` | Prohibit — falta l'àmbit `panels_access`. |
| `500` | Error intern del servidor. |

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