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

# Biomarkers weergeven

> Blader door de biomarkercatalogus

Geeft een gepagineerde catalogus terug van de biomarkers die je API-sleutel voor één herkomst kan bestellen. Koppel ze aan [afspraken](https://docs.anivahealth.com/nl/api/appointments/add-individual-biomarkers.md) of aan [thuistestkits](https://docs.anivahealth.com/nl/api/home-kit-orders/add-individual-biomarkers.md). Gearchiveerde biomarkers worden uitgesloten.

Een biomarker verschijnt in de lijst als een aanvraag bij een lab dat je sleutel mag gebruiken deze levert, en de aanvraag alleen afnamematerialen gebruikt die beschikbaar zijn voor deze herkomst. De monsterbuisjes zijn bepalend, niet het type analyt.

Vereist de scope `panels_access`. Het `pricing`-object vereist ook de scope `prices_view`.

## Verzoek

### Queryparameters

De herkomst heeft één van twee vormen: een testlocatie of een thuistestkit. Stuur er precies één mee. Geen of beide geeft `400` terug.

> [tab] Testlocatie
>
> **location\_id** `string` *required*
>
> De locatie waar de bloedafnames voor de afspraken plaatsvinden. Een biomarker verschijnt in de
> lijst als de aanvraag alleen afnamematerialen gebruikt die deze locatie heeft. Koppel dit aan
> [Locaties weergeven](https://docs.anivahealth.com/nl/api/locations/list-locations.md).

> [tab] Thuistestkit
>
> **home\_kit** `boolean` *required*
>
> Stel in op `true`. Een biomarker verschijnt in de lijst als een aanvraag bij een
> thuistestkit-lab alleen afnamematerialen gebruikt die in een kit zitten: capillair serum en
> EDTA, gedroogde bloedspot, urine en wattenstaafje. Biomarkers die alleen veneus kunnen worden
> afgenomen worden weggelaten.

**rate\_card** `string`

Overschrijf welke tariefkaart `price_cents` gebruikt: `retail`, of het `id` van een tariefkaart die je sleutel mag gebruiken. [Tariefkaart ophalen](https://docs.anivahealth.com/nl/api/pricing/get-rate-card.md) geeft dat `id` terug. Standaard wordt de kaart van het factuuraccount van je API-sleutel gebruikt, anders retail.
`retail_cents` gebruikt altijd de retail-tariefkaart.

**limit** `number`

Maximaal aantal resultaten om terug te geven (1–1.000). Laat dit weg om de hele overeenkomende
catalogus terug te geven — deze is begrensd (hooguit enkele duizenden rijen). Wanneer weggelaten,
geeft `pagination.limit` de waarde van `total` terug.

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

Paginerings-offset. Moet ≥ 0 zijn.

## Respons

**data** `Biomarker[]`

Array van biomarkers die overeenkomen met de query.

**Biomarkervelden**

**id** `number`

Vaste biomarker-ID — geef dit door aan [Aangepaste biomarkers
toevoegen](https://docs.anivahealth.com/nl/api/appointments/add-individual-biomarkers.md).

**slug** `string`

URL-veilige ID.

**name** `string`

Weergavenaam.

**description** `string | null`

Uitgebreide beschrijving, indien beschikbaar.

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

Primaire categorie (bijv. `Hormones`, `Vitamins`).

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

Secundaire categorie.

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

Of deze biomarker een klinische meting of een genetische marker is.

**material** `string | null`

Benodigd monstermateriaal (bijv. `serum`, `whole_blood`).

**unit** `object | null`

Standaard meeteenheid. Gebruik `id` om te verwijzen naar [Eenheden weergeven](https://docs.anivahealth.com/nl/api/units/list-units.md)
als je een vaste identiteit nodig hebt bij naamswijzigingen.

**Eenheidsvelden**

**id** `number`

Vaste ID van de meeteenheid.

**title** `string`

Canonieke titel van de eenheid (bijv. `nmol/L`).

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

Leesbare weergavetitel.

**pricing** `object | null`

Wat deze biomarker kost en hoe deze wordt verkocht — zie [prijsobjecten](#prijsobjecten). `null`
**alleen** als je sleutel de scope `prices_view` mist; een biomarker waarvoor Aniva geen prijs
heeft ingesteld wordt nog steeds teruggegeven, met `pricing.price_cents: null`.

**pagination** `object`

**Pagineringsvelden**

**total** `number`

Totaal aantal rijen dat overeenkomt met de query over alle pagina's.

**limit** `number`

Limiet toegepast op deze pagina. Geeft `total` terug wanneer de queryparameter `limit` is
weggelaten (de hele catalogus is teruggegeven).

**offset** `number`

Offset toegepast op deze pagina.

**has\_more** `boolean`

`true` wanneer er meer pagina's beschikbaar zijn.

## Prijsobjecten

Prijzen hebben overal waar ze voorkomen dezelfde structuur — biomarkers, panels, de
[voorvertoning](https://docs.anivahealth.com/nl/api/appointments/preview-containers.md) van een afspraak en een [offerte](https://docs.anivahealth.com/nl/api/pricing/quote-cart.md). [Prijzen](https://docs.anivahealth.com/nl/concepts/pricing.md) legt het model
erachter uit; dit is het veldoverzicht.

Elk bedrag is een geheel aantal centen.

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

Wat dit kost op **jouw** tariefkaart. `0` is een echte prijs van nul — het item wordt niet los
verkocht, en het `requires`- of `positions`-blok ernaast geeft aan hoe het wel wordt verkocht.
`null` is anders: Aniva heeft geen prijs ingesteld, het is niet kosteloos, het kan niet worden
besteld en het telt niet mee in een totaal.

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

Hetzelfde bedrag volgens de aanbevolen retail-tariefkaart. Altijd aanwezig; gelijk aan `price_cents`
wanneer je sleutel al op de retail-tariefkaart staat.

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

Welk van de twee Aniva-tarieven van je kaart de prijs van deze marker bepaalt. Alleen aanwezig
wanneer de marker een eigen prijs heeft.

**positions** `object[]`

De commerciële aanbiedingen die deze biomarker bevatten, goedkoopste eerst. Bij `price_cents: 0`
zijn dit de enige manieren om de biomarker te bestellen; bij een positieve `price_cents` zijn dit
de bundels waar deze ook deel van uitmaakt. Een positie wordt **één keer** in rekening gebracht en
altijd volledig geleverd.

**id** `string`

Stabiele positie-ID. Koppelt aan `via_position` op een afspraakfactuur.

**name** `string`

Positienaam voor partners.

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

Wat de hele positie op jouw tariefkaart kost, eenmalig gefactureerd. `retail_cents` staat ernaast.

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

Elke biomarker die de positie levert, inclusief degene die je opvroeg.

**includes** `number[]`

De onderdelen naast de biomarker die je opvroeg — wat je erbij krijgt als je deze koopt.

**requires** `object[]`

Aanwezig wanneer deze biomarker een **ratio** is. Als je deze bestelt, komen deze onderdelen tegen
hun eigen prijs in het winkelmandje, en een onderdeel betaal je één keer per winkelmandje, ongeacht hoeveel ratio's ervan afhankelijk zijn. De
eigen `price_cents` van de ratio wordt naast de onderdelen gefactureerd. De meeste ratio's kosten `0`. Elk
item bevat `id`, `name`, `price_cents` en `retail_cents`.

Een ratio waarvan niet alle onderdelen een prijs hebben, ontbreekt helemaal in de catalogus — deze
verschijnt nooit met `price_cents: null`.

Panels hebben alleen `price_cents` en `retail_cents`: een panel heeft één catalogusprijs en geen
posities of onderdelen.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Validatiefout — bijv. geen of twee origins, `limit` buiten bereik, of onbekende/niet-geautoriseerde `rate_card`. |
| `403` | Geen toegang — ontbrekende `panels_access`-scope. |
| `404` | `location_id` verwijst niet naar een testlocatie. |
| `500` | Interne serverfout. |

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