> ## 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`. Зручно для перетворення ідентифікаторів зі [Списку панелей](https://docs.anivahealth.com/uk/api/panels/list-panels.md) або даних запису на повну інформацію (назва, одиниця вимірювання, матеріал, категорія) без перегляду всього каталогу.

Використовує той самий каталог, що й [Список біомаркерів](https://docs.anivahealth.com/uk/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/uk/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/uk/api/units/list-units.md), якщо
тобі потрібна стабільна ідентифікація після перейменувань.

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

**id** `number`

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

**title** `string`

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

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

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

**pricing** `object | null`

Скільки коштує цей біомаркер і як він продається — див. [об’єкти
цін](https://docs.anivahealth.com/uk/api/biomarkers/list-biomarkers.md#ob-yekti-tsin). Має значення `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.