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

# Pobierz biomarker

> Pobierz pojedynczy biomarker według ID

Zwraca pojedynczy biomarker na podstawie jego numerycznego `id`. Przydatne do zamiany identyfikatorów zwracanych przez [Lista paneli](https://docs.anivahealth.com/pl/api/panels/list-panels.md) lub w danych wizyty na pełne szczegóły (nazwa, jednostka, materiał, kategoria) bez przeszukiwania całego katalogu.

Obsługuje ten sam katalog co [Lista biomarkerów](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md), więc wyślij to samo źródło pobrania. Zarchiwizowany biomarker zwraca `404`. To samo dotyczy biomarkera, którego nie możesz zamówić dla tego źródła w laboratoriach dostępnych dla twojego klucza.

Wymaga zakresu `panels_access`. Obiekt `pricing` wymaga dodatkowo zakresu `prices_view`.

## Parametry ścieżki

**id** `number` *required*

Identyfikator biomarkera.

## Parametry zapytania

Źródło pobrania ma jedną z dwóch form: punkt pobrań lub domowy zestaw testowy. Wyślij dokładnie jedną. Brak lub wysłanie obu zwraca `400`.

> [tab] Punkt pobrań
>
> **location\_id** `string` *required*
>
> Lokalizacja, w której odbywa się pobranie podczas wizyty. Biomarker zwraca `404`, chyba że
> jego zlecenie wymaga pobrania wyłącznie do pojemników dostępnych w tej lokalizacji.

> [tab] Domowy zestaw testowy
>
> **home\_kit** `boolean` *required*
>
> Ustaw na `true`. Biomarker zwraca `404`, chyba że zlecenie w laboratorium obsługującym domowe
> zestawy testowe wymaga pobrania wyłącznie do pojemników zawartych w zestawie.

**rate\_card** `string`

Nadpisz cennik używany przez `price_cents`: `retail` lub `id` cennika dostępnego dla twojego klucza. To `id` zwraca [Pobierz cennik](https://docs.anivahealth.com/pl/api/pricing/get-rate-card.md). Domyślnie używany jest cennik przypisany do konta rozliczeniowego twojego klucza API, a w przeciwnym razie detaliczny.

## Odpowiedź

**id** `number`

Stały identyfikator biomarkera.

**slug** `string`

Identyfikator bezpieczny dla URL.

**name** `string`

Nazwa wyświetlana.

**description** `string | null`

Rozbudowany opis, jeśli jest dostępny.

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

Kategoria główna (np. `Hormones`, `Vitamins`).

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

Kategoria dodatkowa.

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

Określa, czy ten biomarker to pomiar kliniczny, czy marker genetyczny.

**material** `string | null`

Wymagany materiał próbki (np. `serum`, `whole_blood`).

**unit** `object | null`

Domyślna jednostka miary. Użyj `id` do powiązania z [Listą jednostek](https://docs.anivahealth.com/pl/api/units/list-units.md),
jeśli potrzebujesz stałej identyfikacji mimo zmian nazw.

**Pola jednostki**

**id** `number`

Stały identyfikator jednostki miary.

**title** `string`

Kanoniczna nazwa jednostki (np. `nmol/L`).

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

Czytelna nazwa wyświetlana.

**pricing** `object | null`

Ile kosztuje ten biomarker i jak jest sprzedawany — zobacz [obiekty
cenowe](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md#obiekty-cenowe). `null` **wyłącznie**, gdy twój klucz nie
ma zakresu `prices_view`; biomarker niewyceniony przez Aniva nadal jest zwracany, z
`pricing.price_cents: null`.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — nieprawidłowe `id`, brak źródła pobrania lub podane dwa źródła, albo nieznany lub nieautoryzowany `rate_card`. |
| `403` | Brak dostępu — brak zakresu `panels_access`. |
| `404` | Nie znaleziono biomarkera, został zarchiwizowany lub nie można go zamówić dla tego źródła pobrania. Również nieznane `location_id`. |
| `500` | Wewnętrzny błąd serwera. |

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