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

# Wyświetl listę biomarkerów

> Przeglądaj katalog biomarkerów

Zwraca stronicowany katalog biomarkerów, które twój klucz API może zamówić dla jednego źródła pobrania. Dodaj je do [wizyt](https://docs.anivahealth.com/pl/api/appointments/add-individual-biomarkers.md) lub do [domowych zestawów testowych](https://docs.anivahealth.com/pl/api/home-kit-orders/add-individual-biomarkers.md). Zarchiwizowane biomarkery są pomijane.

Biomarker pojawia się na liście, gdy realizuje go zlecenie w laboratorium dostępnym dla twojego klucza, a zlecenie wymaga pobrania wyłącznie do pojemników dostępnych dla danego źródła. Decydują probówki, nie typ analitu.

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

## Żądanie

### 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 odbywają się pobrania podczas wizyt. Biomarker pojawia się na liście,
> gdy jego zlecenie wymaga pobrania wyłącznie do pojemników dostępnych w tej lokalizacji.
> Powiąż z [Listą lokalizacji](https://docs.anivahealth.com/pl/api/locations/list-locations.md).

> [tab] Domowy zestaw testowy
>
> **home\_kit** `boolean` *required*
>
> Ustaw na `true`. Biomarker pojawia się na liście, gdy zlecenie w laboratorium obsługującym
> domowe zestawy testowe wymaga pobrania wyłącznie do pojemników zawartych w zestawie: na
> surowicę włośniczkową i EDTA, suchą kroplę krwi, mocz i wymaz. Biomarkery wymagające
> wyłącznie krwi żylnej są pomijane.

**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.
`retail_cents` zawsze korzysta z cennika detalicznego.

**limit** `number`

Maksymalna liczba zwracanych wyników (1–1 000). Pomiń, aby zwrócić cały pasujący katalog — jest
ograniczony (maksymalnie kilka tysięcy wierszy). Po pominięciu `pagination.limit` zwraca wartość
`total`.

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

Przesunięcie stronicowania. Musi wynosić ≥ 0.

## Odpowiedź

**data** `Biomarker[]`

Tablica biomarkerów pasujących do zapytania.

**Pola biomarkera**

**id** `number`

Stały identyfikator biomarkera — przekaż go do [Dodaj własne
biomarkery](https://docs.anivahealth.com/pl/api/appointments/add-individual-biomarkers.md).

**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](#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`.

**pagination** `object`

**Pola stronicowania**

**total** `number`

Łączna liczba wierszy pasujących do zapytania na wszystkich stronach.

**limit** `number`

Limit zastosowany dla tej strony. Zwraca `total`, gdy pominięto parametr zapytania `limit`
(zwrócono cały katalog).

**offset** `number`

Przesunięcie zastosowane dla tej strony.

**has\_more** `boolean`

`true`, gdy dostępnych jest więcej stron.

## Obiekty cenowe

Ceny mają jedną strukturę wszędzie, gdzie się pojawiają — w biomarkerach, panelach,
[podglądzie](https://docs.anivahealth.com/pl/api/appointments/preview-containers.md) wizyty i [wycenie](https://docs.anivahealth.com/pl/api/pricing/quote-cart.md). [Ceny](https://docs.anivahealth.com/pl/concepts/pricing.md) wyjaśniają stojący
za tym model; to jest opis pól.

Każda kwota to całkowita liczba centów.

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

Ile to kosztuje w **twoim** cenniku. `0` to rzeczywista cena zerowa — pozycja nie jest
sprzedawana osobno, a znajdujący się obok blok `requires` lub `positions` określa, w jaki sposób
jest sprzedawana. `null` oznacza co innego: Aniva jej nie wyceniła, nie oznacza to, że nic nie
kosztuje, nie można jej zamówić i nie dolicza się do żadnej sumy.

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

Ta sama kwota w sugerowanym cenniku detalicznym. Zawsze obecna; równa `price_cents`, gdy twój
klucz korzysta już z cennika detalicznego.

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

Która z dwóch stawek Aniva w twoim cenniku wyceniła ten marker. Obecne tylko wtedy, gdy ma własną
cenę.

**positions** `object[]`

Oferty handlowe zawierające ten biomarker, od najtańszej. Przy `price_cents: 0` są one jedynym
sposobem na jego zamówienie; przy dodatnim `price_cents` są to pakiety, do których również
należy. Pozycja jest rozliczana **raz** i zawsze realizowana w całości.

**id** `string`

Stały identyfikator pozycji. Łączy się z `via_position` na rachunku za wizytę.

**name** `string`

Nazwa pozycji widoczna dla partnera.

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

Koszt całej pozycji w twoim cenniku, naliczany raz. Obok znajduje się `retail_cents`.

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

Wszystkie biomarkery zawarte w pozycji, łącznie z tym, o który pytasz.

**includes** `number[]`

Pozostałe elementy poza biomarkerem, o który pytasz — to, co dostajesz razem z nim przy zakupie.

**requires** `object[]`

Obecne, gdy ten biomarker jest **współczynnikiem**. Jego zamówienie dodaje te składniki do koszyka
w ich własnych cenach, a za każdy składnik płacisz raz na koszyk, niezależnie od tego, ile
współczynników z niego korzysta. Własna wartość `price_cents` współczynnika jest naliczana oprócz
jego składników. Większość współczynników kosztuje `0`. Każdy wpis zawiera `id`, `name`,
`price_cents` i `retail_cents`.

Współczynnik, którego nie wszystkie składniki mają cenę, nie występuje w katalogu wcale — nigdy
nie pojawia się z `price_cents: null`.

Panele mają tylko `price_cents` i `retail_cents`: panel ma jedną cenę katalogową i nie ma
pozycji ani składników.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — np. brak źródła lub dwa źródła, `limit` poza zakresem albo nieznany lub nieautoryzowany `rate_card`. |
| `403` | Brak dostępu — brakuje zakresu `panels_access`. |
| `404` | `location_id` nie wskazuje żadnej lokalizacji badania. |
| `500` | Wewnętrzny błąd serwera. |

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