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

# Список единиц измерения

> Просмотреть каталог единиц измерения

Возвращает каталог единиц измерения. Числовой `id` остаётся неизменным при переименованиях — сохраняй его вместе с данными результатов, чтобы можно было обновлять отображаемые названия без нарушения ссылочной целостности.

Требуется scope `panels_access`.

Ты получишь ссылки `unit_id` в данных результатов ([Получить результаты](https://docs.anivahealth.com/ru/api/appointments/get-results.md)) и в единице измерения по умолчанию для каждого биомаркера ([Список биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md)). Используй этот эндпоинт, чтобы преобразовать эти ID в актуальное отображаемое название.

## Ответ

Возвращает массив единиц измерения.

**id** `number`

Постоянный идентификатор единицы измерения.

**title** `string`

Каноническое название единицы измерения (например, `nmol/L`).

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

Необязательное удобочитаемое название для отображения. `null` означает, что переопределения нет — выводи `title` как есть. Заполняется
только тогда, когда каноническое `title` (ориентированное на машинный разбор) отличается от
предпочтительного вида в интерфейсе (например, `ug/dL` → `µg/dL`).

**aliases** `string[]`

Альтернативные написания и синонимы, распознаваемые для этой единицы (например, `["mmol/l", "millimol/L"]`).
Не включает каноническое `title`. Полезно для сопоставления произвольных строк единиц измерения из внешних источников.

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

`physical` — для измеряемых величин (например, `nmol/L`, `mg`). `discrete` — для перечисляемых и категориальных
значений (например, положительный/отрицательный). `logarithmic` — для логарифма величины, например pH или
индекса атерогенности: у такого значения нет линейной шкалы.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `403` | Доступ запрещён — отсутствует scope `panels_access`. |
| `500` | Внутренняя ошибка сервера. |

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