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

Возвращает один биомаркер по его числовому `id`. Удобно, чтобы получать полные данные (название, единица измерения, материал, категория) по ID из [Списка панелей](https://docs.anivahealth.com/ru/api/panels/list-panels.md) или данных записи, не перебирая весь каталог.

Он использует тот же каталог, что и [Список биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md), поэтому передавай тот же источник. Для архивного биомаркера вернётся `404`. То же самое — для биомаркера, который нельзя заказать для этого источника в лабораториях, доступных твоему ключу.

Требуется область доступа `panels_access`. Для объекта `pricing` также требуется область доступа `prices_view`.

## Параметры пути

**id** `number` *required*

Идентификатор биомаркера.

## Параметры запроса

Источник может быть одного из двух видов: локация для сдачи анализов или набор для домашнего теста. Передай ровно один. Если не передать ни одного или передать оба, вернётся `400`.

> [tab] Локация для сдачи анализов
>
> **location\_id** `string` *required*
>
> Локация, в которой проходит забор крови по записи. Для биомаркера вернётся `404`, если забор
> по его заказу идёт не только в контейнеры, которые есть в этой локации.

> [tab] Набор для домашнего теста
>
> **home\_kit** `boolean` *required*
>
> Установи значение `true`. Для биомаркера вернётся `404`, если забор по заказу в лаборатории,
> работающей с наборами для домашнего теста, идёт не только в контейнеры из набора.

**rate\_card** `string`

Переопределяет тарифную карту для `price_cents`: `retail` или `id` тарифной карты, доступной твоему ключу. Этот `id` возвращает [Получить тарифную карту](https://docs.anivahealth.com/ru/api/pricing/get-rate-card.md). По умолчанию используется карта из платёжного аккаунта твоего API-ключа, иначе — розничная.

## Ответ

**id** `number`

Стабильный идентификатор биомаркера.

**slug** `string`

Безопасный для URL идентификатор.

**name** `string`

Отображаемое название.

**description** `string | null`

Подробное описание, если доступно.

**primary\_category** `string | null`

Основная категория (например, `Hormones`, `Vitamins`).

**secondary\_category** `string | null`

Дополнительная категория.

**type** `"clinical" | "genetic"`

Является ли биомаркер клиническим показателем или генетическим маркером.

**material** `string | null`

Требуемый материал пробы (например, `serum`, `whole_blood`).

**unit** `object | null`

Единица измерения по умолчанию. Используй `id` для сопоставления со [Списком единиц измерения](https://docs.anivahealth.com/ru/api/units/list-units.md), если
нужен стабильный идентификатор при переименованиях.

**Поля единицы измерения**

**id** `number`

Стабильный идентификатор единицы измерения.

**title** `string`

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

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

Человекочитаемое отображаемое название.

**pricing** `object | null`

Сколько стоит этот биомаркер и как он продаётся — см. [объекты
цен](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md#obyekty-tsen). `null` **только**, если у твоего ключа нет
области доступа `prices_view`; биомаркер, для которого Aniva не установила цену, всё равно
возвращается с `pricing.price_cents: null`.

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

| Статус | Описание |
| - | - |
| `400` | Ошибка валидации — неверный `id`, не указан источник или указаны оба, либо неизвестная или недоступная `rate_card`. |
| `403` | Доступ запрещён — отсутствует область доступа `panels_access`. |
| `404` | Биомаркер не найден, находится в архиве или его нельзя заказать для этого источника. Также при неизвестном `location_id`. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/biomarkers/42?home_kit=true' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": 42,
  "slug": "vitamin-d-25-oh",
  "name": "Vitamin D (25-OH)",
  "description": "Serum 25-hydroxyvitamin D …",
  "primary_category": "Vitamins",
  "secondary_category": null,
  "type": "clinical",
  "material": "serum",
  "unit": { "id": 1, "title": "nmol/L", "display_title": null },
  "pricing": {
    "price_cents": 3952,
    "retail_cents": 4549,
    "tier": "specialty"
  }
}
```

```json 200 (sold only inside a position) theme={null}
{
  "id": 77,
  "slug": "mean-platelet-volume",
  "name": "Mean Platelet Volume (MPV)",
  "description": null,
  "primary_category": "Haematology",
  "secondary_category": null,
  "type": "clinical",
  "material": "whole_blood",
  "unit": { "id": 7, "title": "fL", "display_title": null },
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.