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

# Vypsat biomarkery

> Procházet katalog biomarkerů

Vrátí stránkovaný katalog biomarkerů, které může tvůj API klíč objednat pro jeden původ odběru. Přidej je k [termínům](https://docs.anivahealth.com/cs/api/appointments/add-individual-biomarkers.md) nebo k [domácím testovacím sadám](https://docs.anivahealth.com/cs/api/home-kit-orders/add-individual-biomarkers.md). Archivované biomarkery jsou vyloučeny.

Biomarker se vypíše tehdy, když ho dodává objednávka v laboratoři, kterou může tvůj klíč používat, a objednávka se odebírá výhradně do odběrových nádobek, které má daný původ odběru k dispozici. Rozhodují zkumavky na vzorky, ne typ analytu.

Vyžaduje scope `panels_access`. Objekt `pricing` navíc vyžaduje scope `prices_view`.

## Požadavek

### Parametry dotazu

Původ odběru má jednu ze dvou podob: odběrové místo nebo domácí testovací sada. Pošli přesně jeden. Žádný nebo oba vrátí `400`.

> [tab] Odběrové místo
>
> **location\_id** `string` *required*
>
> Odběrové místo, kde probíhají odběry krve pro termíny. Biomarker se vypíše tehdy, když se jeho
> objednávka odebírá výhradně do odběrových nádobek, které má toto místo k dispozici. Propoj se
> [Seznamem odběrových míst](https://docs.anivahealth.com/cs/api/locations/list-locations.md).

> [tab] Domácí testovací sada
>
> **home\_kit** `boolean` *required*
>
> Nastav na `true`. Biomarker se vypíše tehdy, když se objednávka v laboratoři pro domácí
> testovací sady odebírá výhradně do nádobek, které sada obsahuje: kapilární sérum a EDTA, suchá
> krevní kapka, moč a stěr. Biomarkery vyžadující pouze žilní odběr jsou vynechány.

**rate\_card** `string`

Přepíše, jaký ceník `price_cents` používá: `retail`, nebo `id` ceníku, který může tvůj klíč použít. Toto `id` vrací [Získat ceník](https://docs.anivahealth.com/cs/api/pricing/get-rate-card.md). Výchozí je ceník na fakturačním účtu tvého API klíče, jinak maloobchodní.
`retail_cents` vždy odpovídá maloobchodnímu ceníku.

**limit** `number`

Maximální počet vrácených výsledků (1–1 000). Pokud parametr vynecháš, vrátí se celý odpovídající
katalog – jeho velikost je omezená (nejvýše několik tisíc řádků). Při vynechání vrací
`pagination.limit` hodnotu `total`.

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

Posun pro stránkování. Musí být ≥ 0.

## Odpověď

**data** `Biomarker[]`

Pole biomarkerů odpovídajících dotazu.

**Pole biomarkeru**

**id** `number`

Stabilní identifikátor biomarkeru – předej ho do [Přidat vlastní
biomarkery](https://docs.anivahealth.com/cs/api/appointments/add-individual-biomarkers.md).

**slug** `string`

Identifikátor vhodný do URL.

**name** `string`

Zobrazovaný název.

**description** `string | null`

Podrobný popis, pokud je k dispozici.

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

Hlavní kategorie (např. `Hormones`, `Vitamins`).

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

Vedlejší kategorie.

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

Určuje, zda jde o klinické měření nebo genetický marker.

**material** `string | null`

Požadovaný typ vzorku (např. `serum`, `whole_blood`).

**unit** `object | null`

Výchozí měrná jednotka. Pokud potřebuješ stabilní identitu i při přejmenování, použij `id`
k dohledání v [Seznamu jednotek](https://docs.anivahealth.com/cs/api/units/list-units.md).

**Pole jednotky**

**id** `number`

Stabilní identifikátor měrné jednotky.

**title** `string`

Kanonický název jednotky (např. `nmol/L`).

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

Čitelnější zobrazovaný název.

**pricing** `object | null`

Kolik tento biomarker stojí a jak se prodává – viz [cenové objekty](#cenove-objekty). `null`
je **pouze** tehdy, když tvému klíči chybí scope `prices_view`; biomarker, který Aniva
neocenila, se stále vrací s hodnotou `pricing.price_cents: null`.

**pagination** `object`

**Pole stránkování**

**total** `number`

Celkový počet řádků odpovídajících dotazu napříč všemi stránkami.

**limit** `number`

Limit použitý pro tuto stránku. Vrací `total`, když byl parametr dotazu `limit` vynechán
(vrátil se celý katalog).

**offset** `number`

Posun použitý pro tuto stránku.

**has\_more** `boolean`

`true`, pokud jsou k dispozici další stránky.

## Cenové objekty

Ceny mají jednotnou podobu všude, kde se objevují – u biomarkerů, panelů, v
[náhledu](https://docs.anivahealth.com/cs/api/appointments/preview-containers.md) termínu i v [cenové nabídce](https://docs.anivahealth.com/cs/api/pricing/quote-cart.md). [Cenotvorba](https://docs.anivahealth.com/cs/concepts/pricing.md) vysvětluje model,
který za tím stojí; toto je reference polí.

Každá částka je celé číslo v centech.

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

Kolik položka stojí v **tvém** ceníku. `0` je skutečná nulová cena – položka se neprodává
samostatně a vedlejší blok `requires` nebo `positions` určuje, jak se prodává místo toho. `null`
je něco jiného: Aniva ji neocenila, nemá nulovou cenu, nelze ji objednat a nepřičítá se k žádnému
součtu.

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

Stejná částka podle doporučeného maloobchodního ceníku. Vždy je přítomna; rovná se `price_cents`,
když tvůj klíč už používá maloobchodní ceník.

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

Která ze dvou sazeb Anivy v tvém ceníku tento biomarker ocenila. Je přítomna pouze tehdy, když má
vlastní cenu.

**positions** `object[]`

Komerční nabídky obsahující tento biomarker, seřazené od nejlevnější. Při `price_cents: 0` jsou
jediným způsobem, jak ho objednat; při kladné hodnotě `price_cents` jde o balíčky, do kterých
také patří. Pozice se účtuje **jednou** a vždy se dodává celá.

**id** `string`

Stabilní identifikátor položky. Propojuje se s `via_position` na vyúčtování termínu.

**name** `string`

Název položky pro partnery.

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

Kolik celá položka stojí v tvém ceníku, účtováno jednou. Vedle ní je `retail_cents`.

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

Všechny biomarkery, které položka poskytuje, včetně toho, na který se dotazuješ.

**includes** `number[]`

Ostatní biomarkery kromě toho, na který se dotazuješ — co dostaneš k tomu, když ho koupíš.

**requires** `object[]`

Přítomno, když je tento biomarker **poměr**. Jeho objednáním se tyto složky přidají do košíku za
své vlastní ceny a každá složka se platí jen jednou za košík, bez ohledu na to, kolik poměrů na ní závisí.
Vlastní `price_cents` poměru se účtuje navíc k jeho složkám. Většina poměrů stojí `0`. Každá
položka obsahuje `id`, `name`, `price_cents` a `retail_cents`.

Poměr, jehož složky nemají všechny nastavenou cenu, v katalogu vůbec není — nikdy
se neobjeví s `price_cents: null`.

Panely obsahují pouze `price_cents` a `retail_cents`: panel má jednu katalogovou cenu a nemá žádné
položky ani složky.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Chyba validace — např. žádný nebo dva zdroje, `limit` mimo rozsah nebo neznámý/neoprávněný `rate_card`. |
| `403` | Zakázáno — chybí scope `panels_access`. |
| `404` | `location_id` neodpovídá žádnému testovacímu místu. |
| `500` | Interní chyba serveru. |

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