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

# Biomarkerek listázása

> Biomarkerkatalógus böngészése

Lapozott katalógust ad vissza azokról a biomarkerekről, amelyeket az API-kulcsod egy adott forrásnál megrendelhet. Ezeket [időpontokhoz](https://docs.anivahealth.com/hu/api/appointments/add-individual-biomarkers.md) vagy [otthoni tesztkészletekhez](https://docs.anivahealth.com/hu/api/home-kit-orders/add-individual-biomarkers.md) csatolhatod. Az archivált biomarkerek nem szerepelnek benne.

Egy biomarker akkor jelenik meg a listában, ha a kulcsod által használható valamelyik laborban leadott rendelés biztosítja, és a rendelés kizárólag a forrásnál rendelkezésre álló tartályokba vesz mintát. A mintavételi csövek döntenek, nem az analit típusa.

A `panels_access` scope szükséges hozzá. A `pricing` objektumhoz a `prices_view` scope is szükséges.

## Kérés

### Lekérdezési paraméterek

A forrás kétféle lehet: tesztelési helyszín vagy otthoni tesztkészlet. Pontosan egyet küldj el. Ha egyiket sem vagy mindkettőt megadod, `400` választ kapsz.

> [tab] Tesztelési helyszín
>
> **location\_id** `string` *required*
>
> A helyszín, ahol az időpontok vérvétele történik. Egy biomarker akkor jelenik meg a listában,
> ha a rendelése kizárólag az adott helyszínen rendelkezésre álló tartályokba vesz mintát. Vesd
> össze a [Helyszínek listázása](https://docs.anivahealth.com/hu/api/locations/list-locations.md) végponttal.

> [tab] Otthoni tesztkészlet
>
> **home\_kit** `boolean` *required*
>
> Állítsd `true` értékre. Egy biomarker akkor jelenik meg a listában, ha egy otthoni
> tesztkészletes laborban leadott rendelés kizárólag a készletben lévő tartályokba vesz mintát:
> kapilláris szérum és EDTA, szárított vércsepp, vizelet és törlet. A csak vénásan vehető
> biomarkerek kimaradnak.

**rate\_card** `string`

Felülírja, hogy a `price_cents` melyik árlistát használja: `retail`, vagy egy olyan árlista `id` azonosítója, amelyet a kulcsod használhat. Ezt az `id` azonosítót az [Árlista lekérése](https://docs.anivahealth.com/hu/api/pricing/get-rate-card.md) adja vissza. Alapértelmezés szerint az API-kulcsod számlázási fiókjához tartozó árlistát használja, egyébként a fogyasztói árlistát.
A `retail_cents` mindig a fogyasztói árlistát használja.

**limit** `number`

A visszaadható találatok maximális száma (1–1 000). Hagyd el a teljes egyező katalógus lekéréséhez
— mérete korlátozott (legfeljebb néhány ezer sor). Ha elhagyod, a `pagination.limit` a `total`
értékét adja vissza.

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

Lapozási eltolás. Értéke ≥ 0 kell hogy legyen.

## Válasz

**data** `Biomarker[]`

A lekérdezésnek megfelelő biomarkerek tömbje.

**Biomarker mezői**

**id** `number`

Stabil biomarker-azonosító — ezt add át az [Egyéni biomarkerek
hozzáadása](https://docs.anivahealth.com/hu/api/appointments/add-individual-biomarkers.md) végpontnak.

**slug** `string`

URL-barát azonosító.

**name** `string`

Megjelenített név.

**description** `string | null`

Hosszabb leírás, ha elérhető.

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

Elsődleges kategória (pl. `Hormones`, `Vitamins`).

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

Másodlagos kategória.

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

Azt jelzi, hogy a biomarker klinikai mérés vagy genetikai marker.

**material** `string | null`

Szükséges mintaanyag (pl. `serum`, `whole_blood`).

**unit** `object | null`

Alapértelmezett mértékegység. Használd az `id` mezőt a [Mértékegységek
listázása](https://docs.anivahealth.com/hu/api/units/list-units.md) végponthoz való feloldáshoz, ha az átnevezések során is
stabil azonosításra van szükséged.

**Mértékegység mezői**

**id** `number`

Stabil mértékegység-azonosító.

**title** `string`

Szabványos mértékegység-megnevezés (pl. `nmol/L`).

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

Olvasható megjelenítési név.

**pricing** `object | null`

Mennyibe kerül ez a biomarker és hogyan értékesítik — lásd az [árobjektumokat](#arobjektumok).
**Csak** akkor `null`, ha a kulcsod nem rendelkezik a `prices_view` scope-pal; az Aniva által
még nem beárazott biomarkert is visszaadja a rendszer, `pricing.price_cents: null` értékkel.

**pagination** `object`

**Lapozás mezői**

**total** `number`

A lekérdezésnek megfelelő összes sor az összes oldalon.

**limit** `number`

Erre az oldalra alkalmazott korlát. A `total` értéket adja vissza, ha a `limit` lekérdezési
paramétert elhagytad (a teljes katalógust adta vissza).

**offset** `number`

Erre az oldalra alkalmazott eltolás.

**has\_more** `boolean`

`true`, ha további oldalak is elérhetők.

## Árobjektumok

Az árazás mindenhol ugyanazt a felépítést követi — a biomarkereknél, a paneleknél, az időpont
[előnézeténél](https://docs.anivahealth.com/hu/api/appointments/preview-containers.md) és az [árajánlatnál](https://docs.anivahealth.com/hu/api/pricing/quote-cart.md). Az [Árazás](https://docs.anivahealth.com/hu/concepts/pricing.md) oldal bemutatja a mögötte
lévő modellt; ez a mezők referenciája.

Minden összeg egész centben értendő.

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

Mennyibe kerül ez a **te** árlistádon. A `0` valódi nulla ár — a tétel önállóan nem kapható, a
mellette lévő `requires` vagy `positions` blokk mondja meg, hogyan értékesítik helyette. A `null`
más: az Aniva nem árazta be, nem díjmentes, nem rendelhető, és nem adódik hozzá egyetlen
végösszeghez sem.

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

Ugyanez az összeg az ajánlott fogyasztói árlistán. Mindig szerepel; megegyezik a `price_cents`
értékével, ha a kulcsod már a fogyasztói árlistát használja.

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

Az árlistád két Aniva-díjszabása közül melyik árazta be ezt a markert. Csak akkor szerepel, ha
saját ára van.

**positions** `object[]`

Az ezt a biomarkert tartalmazó kereskedelmi ajánlatok, a legolcsóbbtól kezdve. `price_cents: 0`
esetén csak ezeken keresztül rendelhető meg; pozitív `price_cents` esetén ezek azok a csomagok,
amelyekhez szintén tartozik. Egy pozíciót **egyszer** számláznak ki, és mindig egészben teljesül.

**id** `string`

Állandó tételazonosító. Az időpont számláján a `via_position` mezőhöz kapcsolódik.

**name** `string`

A partnernek megjelenő tételnév.

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

A teljes tétel ára az árlistádon, egyszer számlázva. Mellette szerepel a `retail_cents`.

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

Minden biomarker, amelyet a tétel tartalmaz, beleértve a lekérdezettet is.

**includes** `number[]`

A lekérdezett biomarkeren kívüli további elemek – minden, ami még vele jár, ha megveszed.

**requires** `object[]`

Akkor szerepel, ha ez a biomarker egy **arány**. A megrendelése ezeket az összetevőket a saját
árukon teszi a kosárba, és egy összetevőt kosaranként csak egyszer fizetsz ki, függetlenül attól,
hány arány épül rá. Az arány saját `price_cents` értékét az összetevőkön felül számlázzuk. A
legtöbb arány ára `0`. Minden bejegyzés tartalmazza az `id`, `name`, `price_cents` és
`retail_cents` mezőket.

Az az arány, amelynek nincs minden összetevője beárazva, egyáltalán nem szerepel a katalógusban –
soha nem jelenik meg `price_cents: null` értékkel.

A panelek csak `price_cents` és `retail_cents` mezőket tartalmaznak: egy panelnek egyetlen
katalógusára van, tételek és összetevők nélkül.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Érvényesítési hiba – pl. hiányzó vagy két forrás, tartományon kívüli `limit`, vagy ismeretlen/jogosulatlan `rate_card`. |
| `403` | Tiltott – hiányzik a `panels_access` scope. |
| `404` | A `location_id` nem felel meg egyetlen vizsgálati helyszínnek sem. |
| `500` | Belső szerverhiba. |

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