> ## 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 el catálogo de unidades de medida

Devuelve el catálogo de unidades de medida. El `id` numérico se mantiene estable aunque cambie el nombre: guárdalo al almacenar datos de resultados para poder actualizar los títulos mostrados sin romper la integridad referencial.

Requiere el scope `panels_access`.

Recibirás referencias `unit_id` en los payloads de resultados ([Obtener resultados](https://docs.anivahealth.com/es/api/appointments/get-results.md)) y en la unidad predeterminada de cada biomarcador ([Listar biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md)). Usa este endpoint para resolver esos ID en su título mostrado actual.

## Respuesta

Devuelve un array de unidades.

**id** `number`

Identificador estable de la unidad de medida.

**title** `string`

Título canónico de la unidad (p. ej., `nmol/L`).

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

Valor alternativo opcional para mostrar en pantalla. `null` indica que no hay ninguno: muestra
`title` tal cual. Solo se rellena cuando el `title` canónico (que prioriza el análisis automático)
difiere de la forma preferida en la interfaz (p. ej., `ug/dL` → `µg/dL`).

**aliases** `string[]`

Grafías alternativas y sinónimos reconocidos para esta unidad (p. ej., `["mmol/l", "millimol/L"]`).
Excluye el `title` canónico. Útil para emparejar cadenas de texto libre de unidades procedentes de
fuentes externas.

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

`physical` para magnitudes medibles (p. ej., `nmol/L`, `mg`). `discrete` para valores enumerados o
categóricos (p. ej., positivo/negativo). `logarithmic` para el logaritmo de una magnitud, como el
pH o un índice aterogénico: el valor no tiene escala lineal.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `403` | Prohibido: falta el scope `panels_access`. |
| `500` | Error interno 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.