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

# Отримати список біомаркерів

> Переглянути каталог біомаркерів

Повертає каталог біомаркерів із пагінацією, які твій API-ключ може замовити для одного джерела забору. Додавай їх до [записів](https://docs.anivahealth.com/uk/api/appointments/add-individual-biomarkers.md) або до [наборів для домашнього тесту](https://docs.anivahealth.com/uk/api/home-kit-orders/add-individual-biomarkers.md). Архівовані біомаркери виключено.

Біомаркер потрапляє до списку, якщо його забезпечує замовлення в лабораторії, якою може користуватися твій ключ, і забір за цим замовленням виконується лише в ті контейнери, які є в цьому джерелі. Вирішальне значення мають пробірки для зразків, а не тип аналіту.

Потребує дозволу `panels_access`. Для об’єкта `pricing` також потрібен дозвіл `prices_view`.

## Запит

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

Джерело забору має один із двох форматів: локація тестування або набір для домашнього тесту. Передай рівно одне. Якщо не передати жодного або передати обидва, повернеться `400`.

> [tab] Локація тестування
>
> **location\_id** `string` *required*
>
> Локація, де проводиться забір крові за записами. Біомаркер потрапляє до списку, якщо забір за його замовленням виконується лише в
> контейнери, які є в цій локації. Зістав зі [Списком локацій](https://docs.anivahealth.com/uk/api/locations/list-locations.md).

> [tab] Набір для домашнього тесту
>
> **home\_kit** `boolean` *required*
>
> Укажи `true`. Біомаркер потрапляє до списку, якщо забір за замовленням у лабораторії для домашніх тестів виконується лише в
> контейнери, які входять до набору: капілярна сироватка та EDTA, суха крапля крові, сеча й мазок.
> Біомаркери, для яких потрібна лише венозна кров, виключено.

**rate\_card** `string`

Перевизначає прайс-лист, який використовує `price_cents`: `retail` або `id` прайс-листа, яким може користуватися твій ключ. Цей `id` повертає [Отримати прайс-лист](https://docs.anivahealth.com/uk/api/pricing/get-rate-card.md). За замовчуванням використовується прайс-лист платіжного акаунта твого API-ключа, інакше — роздрібний.
`retail_cents` завжди відповідає роздрібному прайс-листу.

**limit** `number`

Максимальна кількість результатів у відповіді (1–1 000). Пропусти параметр, щоб отримати весь відповідний каталог — його розмір обмежений (щонайбільше
кілька тисяч рядків). Якщо параметр пропущено, `pagination.limit` повторює значення `total`.

**offset** `number` (default: 0)

Зміщення пагінації. Має бути ≥ 0.

## Відповідь

**data** `Biomarker[]`

Масив біомаркерів, що відповідають запиту.

**Поля біомаркера**

**id** `number`

Стабільний ідентифікатор біомаркера — передай його в [Додати індивідуальні
біомаркери](https://docs.anivahealth.com/uk/api/appointments/add-individual-biomarkers.md).

**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/uk/api/units/list-units.md),
якщо тобі потрібна стабільна ідентифікація після перейменувань.

**Поля одиниці вимірювання**

**id** `number`

Стабільний ідентифікатор одиниці вимірювання.

**title** `string`

Канонічна назва одиниці (наприклад, `nmol/L`).

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

Зручна для читання назва.

**pricing** `object | null`

Скільки коштує цей біомаркер і як він продається — див. [об’єкти цін](#ob-yekti-tsin). Має значення `null`
**лише** тоді, коли твій ключ не має дозволу `prices_view`; біомаркер без установленої Aniva ціни
все одно повертається з `pricing.price_cents: null`.

**pagination** `object`

**Поля пагінації**

**total** `number`

Загальна кількість рядків, що відповідають запиту, на всіх сторінках.

**limit** `number`

Ліміт, застосований до цієї сторінки. Повторює значення `total`, якщо параметр запиту `limit` було пропущено (повернуто весь
каталог).

**offset** `number`

Зміщення, застосоване до цієї сторінки.

**has\_more** `boolean`

`true`, якщо доступні інші сторінки.

## Об’єкти цін

Ціноутворення має єдину структуру скрізь, де воно трапляється — у біомаркерах, панелях, у
[попередньому перегляді](https://docs.anivahealth.com/uk/api/appointments/preview-containers.md) запису та [розрахунку вартості](https://docs.anivahealth.com/uk/api/pricing/quote-cart.md). [Ціноутворення](https://docs.anivahealth.com/uk/concepts/pricing.md) пояснює модель,
що лежить в основі; це довідник полів.

Усі суми вказано в цілих центах.

**price\_cents** `integer | null`

Скільки це коштує за **твоїм** прайс-листом. `0` — це реальна нульова ціна: елемент не продається
окремо, а блок `requires` або `positions` поруч вказує, як він продається натомість. `null` означає
інше: Aniva не встановила ціну, це не безплатно, його не можна замовити, і він нічого не додає до
жодної суми.

**retail\_cents** `integer | null`

Та сама сума за рекомендованим роздрібним прайс-листом. Завжди присутнє; дорівнює `price_cents`, якщо твій
ключ уже використовує роздрібний прайс-лист.

**tier** `"routine" | "specialty"`

Який із двох тарифів Aniva у твоєму прайс-листі визначає ціну цього маркера. Присутнє лише тоді, коли маркер має власну
ціну.

**positions** `object[]`

Комерційні пропозиції, що містять цей біомаркер, від найдешевшої. За `price_cents: 0` це
єдиний спосіб його замовити; за додатного `price_cents` це пакети, до яких він також входить.
Позиція оплачується **один раз** і завжди надається повністю.

**id** `string`

Стабільний ідентифікатор позиції. Пов’язується з `via_position` у рахунку за запис.

**name** `string`

Назва позиції для партнера.

**price\_cents** `integer | null`

Скільки коштує вся позиція у твоїй тарифній картці, сплачується один раз. Поруч іде `retail_cents`.

**biomarker\_ids** `number[]`

Усі біомаркери, які надає позиція, включно із запитаним.

**includes** `number[]`

Інші елементи, крім запитаного біомаркера — те, що йде разом із ним, коли ти його купуєш.

**requires** `object[]`

Присутнє, коли цей біомаркер є **співвідношенням**. Його замовлення додає ці компоненти до
кошика за їхніми власними цінами, і компонент оплачується один раз на кошик, хоч скільки
співвідношень на нього спирається. Власне `price_cents` співвідношення нараховується додатково до
його компонентів. Більшість співвідношень коштують `0`. Кожен елемент містить `id`, `name`,
`price_cents` і `retail_cents`.

Співвідношення, у якого не всі компоненти мають ціну, взагалі відсутнє в каталозі — воно ніколи
не з’являється з `price_cents: null`.

Панелі мають лише `price_cents` і `retail_cents`: у панелі єдина ціна в каталозі, без позицій
і компонентів.

## Відповіді з помилками

| Статус | Опис |
| - | - |
| `400` | Помилка валідації — наприклад, не вказано джерело або вказано два джерела, `limit` поза діапазоном чи невідома або недоступна `rate_card`. |
| `403` | Доступ заборонено — бракує дозволу `panels_access`. |
| `404` | `location_id` не відповідає жодній локації тестування. |
| `500` | Внутрішня помилка сервера. |

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

```json 200 theme={null}
{
  "data": [
    {
      "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",
        "positions": [
          {
            "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
            "name": "Vitamin panel",
            "price_cents": 6900,
            "retail_cents": 7935,
            "biomarker_ids": [42, 43, 44],
            "includes": [43, 44]
          }
        ]
      }
    }
  ],
  "pagination": { "total": 17, "limit": 5, "offset": 0, "has_more": true }
}
```


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