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

# Listar unidades

> Explorar o catálogo de unidades de medida

Devolve o catálogo de unidades de medida. O `id` numérico mantém-se estável mesmo após alterações de nome — guarda-o ao persistir dados de resultados para que os títulos de apresentação possam ser atualizados sem quebrar a integridade referencial.

Requer o âmbito `panels_access`.

Vais receber referências `unit_id` nos payloads de resultados ([Obter resultados](https://docs.anivahealth.com/pt/api/appointments/get-results.md)) e na unidade predefinida de cada biomarcador ([Listar biomarcadores](https://docs.anivahealth.com/pt/api/biomarkers/list-biomarkers.md)). Usa este endpoint para resolver esses IDs para um título de apresentação atual.

## Resposta

Devolve um array de unidades.

**id** `number`

Identificador estável da unidade de medida.

**title** `string`

Título canónico da unidade (por ex., `nmol/L`).

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

Substituição opcional para apresentação legível. `null` significa que não existe substituição — apresenta `title` tal como está. Só é
preenchido quando o `title` canónico (que prioriza a leitura automática) difere da
forma preferida para a interface (por ex., `ug/dL` → `µg/dL`).

**aliases** `string[]`

Grafias alternativas e sinónimos reconhecidos para esta unidade (por ex., `["mmol/l", "millimol/L"]`).
Exclui o `title` canónico. Útil para corresponder strings de unidades em texto livre de fontes externas.

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

`physical` para grandezas mensuráveis (por ex., `nmol/L`, `mg`). `discrete` para valores enumerados/categóricos
(por ex., positivo/negativo). `logarithmic` para o logaritmo de uma grandeza, como o pH ou um
índice aterogénico: o valor não tem uma escala linear.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `403` | Proibido — falta o âmbito `panels_access`. |
| `500` | Erro interno do 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.