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

> Einen einzelnen Biomarker anhand der ID abrufen

Gibt einen einzelnen Biomarker anhand seiner numerischen `id` zurück. Nützlich, um die von [Panels auflisten](https://docs.anivahealth.com/de/api/panels/list-panels.md) oder in Termin-Payloads zurückgegebenen IDs in vollständige Details (Name, Einheit, Material, Kategorie) aufzulösen, ohne den gesamten Katalog zu durchsuchen.

Der Endpunkt liefert denselben Katalog wie [Biomarker auflisten](https://docs.anivahealth.com/de/api/biomarkers/list-biomarkers.md), sende also dieselbe Herkunft. Ein archivierter Biomarker gibt `404` zurück. Dasselbe gilt für einen Biomarker, den du für diese Herkunft nicht über die Labore bestellen kannst, die dein Schlüssel nutzen darf.

Erfordert den Scope `panels_access`. Für das `pricing`-Objekt ist zusätzlich der Scope `prices_view` erforderlich.

## Pfadparameter

**id** `number` *required*

Biomarker-Kennung.

## Query-Parameter

Die Herkunft hat eine von zwei Formen: ein Teststandort oder ein Heimtest-Kit. Sende genau eine. Keine oder beide geben `400` zurück.

> [tab] Teststandort
>
> **location\_id** `string` *required*
>
> Der Standort, an dem die Blutabnahme für den Termin stattfindet. Der Biomarker gibt `404` zurück, es sei denn, seine Bestellung nutzt ausschließlich Probengefäße, die dieser Standort führt.

> [tab] Heimtest-Kit
>
> **home\_kit** `boolean` *required*
>
> Auf `true` setzen. Der Biomarker gibt `404` zurück, es sei denn, eine Bestellung bei einem Heimtest-Kit-Labor nutzt ausschließlich die Probengefäße, die ein Kit enthält.

**rate\_card** `string`

Überschreibe, welche Preisliste `price_cents` verwendet: `retail` oder die `id` einer Preisliste, die dein Schlüssel nutzen darf. [Preisliste abrufen](https://docs.anivahealth.com/de/api/pricing/get-rate-card.md) gibt diese `id` zurück. Standardmäßig gilt die Preisliste des Abrechnungskontos deines API-Schlüssels, sonst die Endkunden-Preisliste.

## Antwort

**id** `number`

Stabile Biomarker-Kennung.

**slug** `string`

URL-sichere Kennung.

**name** `string`

Anzeigename.

**description** `string | null`

Ausführliche Beschreibung, sofern verfügbar.

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

Primärkategorie (z. B. `Hormones`, `Vitamins`).

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

Sekundärkategorie.

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

Gibt an, ob dieser Biomarker ein klinischer Messwert oder ein genetischer Marker ist.

**material** `string | null`

Erforderliches Probenmaterial (z. B. `serum`, `whole_blood`).

**unit** `object | null`

Standard-Maßeinheit. Nutze `id` zum Abgleich mit [Einheiten auflisten](https://docs.anivahealth.com/de/api/units/list-units.md), wenn du eine stabile Identität über Umbenennungen hinweg brauchst.

**Einheiten-Felder**

**id** `number`

Stabile Kennung der Maßeinheit.

**title** `string`

Kanonische Bezeichnung der Einheit (z. B. `nmol/L`).

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

Lesbare Anzeigebezeichnung.

**pricing** `object | null`

Was dieser Biomarker kostet und wie er verkauft wird – siehe [Preisobjekte](https://docs.anivahealth.com/de/api/biomarkers/list-biomarkers.md#preisobjekte). `null` **nur**, wenn deinem Schlüssel der Scope `prices_view` fehlt; ein Biomarker, für den Aniva keinen Preis festgelegt hat, wird trotzdem zurückgegeben, mit `pricing.price_cents: null`.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Validierungsfehler – ungültige `id`, keine oder zwei Herkunftsangaben oder unbekannte/nicht autorisierte `rate_card`. |
| `403` | Zugriff verweigert – Scope `panels_access` fehlt. |
| `404` | Biomarker nicht gefunden, archiviert oder für diese Herkunft nicht bestellbar. Auch bei unbekannter `location_id`. |
| `500` | Interner Serverfehler. |

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