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

# Biomarker ophalen

> Haal één biomarker op via ID

Geeft één biomarker terug op basis van het numerieke `id`. Handig om de ID's uit [Panels weergeven](https://docs.anivahealth.com/nl/api/panels/list-panels.md) of afspraak-payloads om te zetten naar volledige details (naam, eenheid, materiaal, categorie) zonder de hele catalogus te doorzoeken.

Het gebruikt dezelfde catalogus als [Biomarkers weergeven](https://docs.anivahealth.com/nl/api/biomarkers/list-biomarkers.md), dus stuur dezelfde herkomst mee. Een gearchiveerde biomarker geeft `404` terug. Dat geldt ook voor een biomarker die je voor die herkomst niet kunt bestellen bij de labs die je sleutel mag gebruiken.

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

## Padparameters

**id** `number` *required*

Biomarker-ID.

## 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 bloedafname voor de afspraak plaatsvindt. De biomarker geeft `404` terug,
> tenzij de aanvraag alleen afnamematerialen gebruikt die deze locatie heeft.

> [tab] Thuistestkit
>
> **home\_kit** `boolean` *required*
>
> Stel in op `true`. De biomarker geeft `404` terug, tenzij een aanvraag bij een thuistestkit-lab
> alleen afnamematerialen gebruikt die in een kit zitten.

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

## Respons

**id** `number`

Vaste biomarker-ID.

**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](https://docs.anivahealth.com/nl/api/biomarkers/list-biomarkers.md#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`.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Validatiefout — ongeldig `id`, geen of twee herkomsten, of onbekende/niet-geautoriseerde `rate_card`. |
| `403` | Geen toegang — scope `panels_access` ontbreekt. |
| `404` | Biomarker niet gevonden, gearchiveerd of niet bestelbaar voor deze herkomst. Ook bij een onbekend `location_id`. |
| `500` | Interne serverfout. |

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