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

> Den Biomarker-Katalog durchsehen

Gibt einen paginierten Katalog der Biomarker zurück, die dein API-Schlüssel für eine Herkunft bestellen kann. Füge sie zu [Terminen](https://docs.anivahealth.com/de/api/appointments/add-individual-biomarkers.md) oder [Heimtest-Kits](https://docs.anivahealth.com/de/api/home-kit-orders/add-individual-biomarkers.md) hinzu. Archivierte Biomarker sind ausgeschlossen.

Ein Biomarker erscheint in der Liste, wenn eine Bestellung bei einem Labor, das dein Schlüssel nutzen darf, ihn liefert und die Bestellung ausschließlich Probengefäße nutzt, die für diese Herkunft verfügbar sind. Die Probenröhrchen entscheiden, nicht der Analyttyp.

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

## Anfrage

### 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 Blutabnahmen für die Termine stattfinden. Ein Biomarker erscheint in der Liste, wenn seine Bestellung ausschließlich Probengefäße nutzt, die dieser Standort führt. Gleiche dies mit [Standorte auflisten](https://docs.anivahealth.com/de/api/locations/list-locations.md) ab.

> [tab] Heimtest-Kit
>
> **home\_kit** `boolean` *required*
>
> Auf `true` setzen. Ein Biomarker erscheint in der Liste, wenn eine Bestellung bei einem Heimtest-Kit-Labor ausschließlich die Probengefäße nutzt, die ein Kit enthält: kapillares Serum und EDTA, Trockenblut, Urin und Abstrich. Rein venöse Biomarker werden ausgelassen.

**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.
`retail_cents` verwendet immer die Endkunden-Preisliste.

**limit** `number`

Maximale Anzahl zurückgegebener Ergebnisse (1–1.000). Lasse den Parameter weg, um den gesamten passenden Katalog zurückzugeben – er ist begrenzt (höchstens einige tausend Zeilen). Wenn er weggelassen wird, gibt `pagination.limit` den Wert von `total` zurück.

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

Paginierungs-Offset. Muss ≥ 0 sein.

## Antwort

**data** `Biomarker[]`

Array der Biomarker, die der Abfrage entsprechen.

**Biomarker-Felder**

**id** `number`

Stabile Biomarker-Kennung – übergib diese an [Individuelle Biomarker hinzufügen](https://docs.anivahealth.com/de/api/appointments/add-individual-biomarkers.md).

**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](#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`.

**pagination** `object`

**Paginierungsfelder**

**total** `number`

Gesamtanzahl der Zeilen über alle Seiten, die der Abfrage entsprechen.

**limit** `number`

Auf diese Seite angewendetes Limit. Gibt `total` zurück, wenn der Query-Parameter `limit` weggelassen wurde (der gesamte Katalog wurde zurückgegeben).

**offset** `number`

Auf diese Seite angewendeter Offset.

**has\_more** `boolean`

`true`, wenn weitere Seiten verfügbar sind.

## Preisobjekte

Preisangaben haben überall dieselbe Struktur – bei Biomarkern, Panels, der
[Vorschau](https://docs.anivahealth.com/de/api/appointments/preview-containers.md) für Termine und einem [Angebot](https://docs.anivahealth.com/de/api/pricing/quote-cart.md). [Preise](https://docs.anivahealth.com/de/concepts/pricing.md) erklärt das Modell
dahinter; dies ist die Feldreferenz.

Jeder Betrag wird als Ganzzahl in Cent angegeben.

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

Was dies laut **deiner** Preisliste kostet. `0` ist ein echter Preis von null – der Artikel wird nicht einzeln verkauft, und der `requires`- oder `positions`-Block daneben gibt an, wie er stattdessen verkauft wird. `null` ist etwas anderes: Aniva hat keinen Preis dafür festgelegt, der Artikel ist nicht kostenfrei, kann nicht bestellt werden und fließt in keine Summe ein.

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

Derselbe Betrag laut empfohlener Endkunden-Preisliste. Immer vorhanden; entspricht `price_cents`, wenn dein Schlüssel bereits die Endkunden-Preisliste nutzt.

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

Welcher der beiden Aniva-Tarife deiner Preisliste diesen Marker bepreist hat. Nur vorhanden, wenn er einen eigenen Preis hat.

**positions** `object[]`

Die kommerziellen Angebote, die diesen Biomarker enthalten, das günstigste zuerst. Bei `price_cents: 0` sind sie die einzige Möglichkeit, ihn zu bestellen; bei einem positiven `price_cents` sind sie die Bundles, zu denen er zusätzlich gehört. Eine Position wird **einmal** abgerechnet und immer vollständig geliefert.

**id** `string`

Stabile Positions-ID. Verknüpft mit `via_position` auf einer Terminrechnung.

**name** `string`

Positionsname für Partner.

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

Was die gesamte Position in deiner Preisliste kostet, einmalig abgerechnet. `retail_cents` steht daneben.

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

Jeder Biomarker, den die Position liefert, einschließlich des abgefragten.

**includes** `number[]`

Alle weiteren Bestandteile außer dem abgefragten Biomarker – was beim Kauf mitgeliefert wird.

**requires** `object[]`

Vorhanden, wenn dieser Biomarker ein **Verhältnis** ist. Bei der Bestellung landen diese
Komponenten zu ihren eigenen Preisen im Warenkorb, und jede Komponente wird pro Warenkorb nur
einmal bezahlt, egal wie viele Verhältnisse sie nutzen. Die eigenen `price_cents` des
Verhältnisses werden zusätzlich zu seinen Komponenten berechnet. Die meisten Verhältnisse kosten
`0`. Jeder Eintrag enthält `id`, `name`, `price_cents` und `retail_cents`.

Ein Verhältnis, bei dem nicht alle Komponenten einen Preis haben, fehlt komplett im Katalog – es
erscheint nie mit `price_cents: null`.

Panels haben nur `price_cents` und `retail_cents`: Ein Panel hat einen einzigen Katalogpreis und
keine Positionen oder Komponenten.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Validierungsfehler – z. B. kein Ursprung oder zwei Ursprünge, `limit` außerhalb des gültigen Bereichs oder unbekannte/nicht autorisierte `rate_card`. |
| `403` | Zugriff verweigert – der Scope `panels_access` fehlt. |
| `404` | `location_id` gehört zu keinem Teststandort. |
| `500` | Interner Serverfehler. |

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