Buche Bluttests direkt in deinem eigenen Produkt

Ein API-Schlüssel gibt dir Zugriff auf 45 Endpunkte, von der Buchung bis zu den Laborergebnissen

Die Aniva Partner-API bucht eine Blutabnahme an über 25 Standorten in Deutschland, fügt diesem Termin Untersuchungen hinzu und liefert klinische und genetische Ergebnisse als JSON. Jede Anfrage erfordert einen Header und die Basis-URL ist in jeder Umgebung gleich.

API-Schlüssel anfordern

Dokumentation lesen

Wann du Aniva einsetzen kannst

Nutze Aniva, wenn deine Kunden eine Blutuntersuchung buchen müssen

Nutze die Termin-Endpunkte für eine Blutabnahme in der Praxis und die Heim-Kit-Endpunkte für ein Testkit per Post.

Nutze die Ergebnis-Endpunkte für klinische Werte, genetische Werte und den PDF-Bericht.

Nutze die Katalog-Endpunkte, um die Biomarker, Testpanels und Einheiten abzurufen, die Aniva anbietet.

Verwende die dokumentierten Pfade unter https://anivahealth.com/api/v1/ und erfinde keine eigenen Endpunkte.

POST /api/v1/appointments

curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'

const res = await fetch('https://anivahealth.com/api/v1/appointments', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.ANIVA_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    profile_id: profile.id,
    location_id: location.id,
    scheduled_at: '2026-05-15T12:30:00+02:00', // offset required
  }),
});
const appointment = await res.json();

{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T12:30:00+02:00",
  "status": "confirmed",
  "test_method": "practitioner",
  "panels": [],
  "shipments": []
}

Der grundlegende Ablauf besteht aus vier Anfragen

GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm

45 Endpunkte sind dokumentiert und ab sofort live

Für die Authentifizierung ist nur ein Anfrage-Header nötig

Jeder Pfad beginnt mit dem v1-Präfix

25+

An Standorten in Deutschland ist die Blutabnahme möglich

Vier Anfragen ergeben eine funktionierende Integration

Vier Schritte von der Buchung bis zum Laborergebnis

Jede Anfrage liefert die ID, die die nächste benötigt. Eine einfache Integration besteht also aus vier Anfragen, bevor du Panels, Umbuchungen oder Kurierdienste hinzufügst.

Schritt 01 · GET /locations

Du listest die Standorte auf, die dein Schlüssel buchen kann.

Die Antwort liefert dir jede Adresse, die Öffnungszeiten und die Zeitzone, sodass Kunden nur verfügbare Zeitslots sehen.

Tests

Schritt 02 · POST /profiles

Du erstellst ein Profil für den Kunden

Ein Profil benötigt einen Namen, einen Geschlechtscode, ein Geburtsdatum und deine Profilgruppe, die eine UUID oder deinen eigenen Slug akzeptiert.

Tests

Schritt 03 · POST /appointments

Du buchst den Termin zu einer bestimmten Uhrzeit

Die Buchung benötigt die Profil-ID, die Standort-ID und ein ISO-8601-Datum mit Zeitzonenversatz oder dem Z-Suffix.

Tests

Schritt 04 · POST /appointments/{id}/confirm

Du bestätigst die Blutabnahme mit dem Barcode des Kits

Diese Anfrage startet den Laborauftrag und fixiert den Termin – ändere also jedes Panel, bevor du es absendest.

Tests

POST /api/v1/appointments

curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'

Funktion

Jede Ressourcengruppe ist eine REST-Sammlung

Du kannst eine Blutabnahme in einer Klinik oder ein Testkit für zu Hause per Post bestellen. Beide kommen im selben Format an, sodass du den Code zum Auslesen der Ergebnisse nur einmal schreiben musst.

Profile · 4 Endpunkte

Ein Profil ist die Person, die getestet wird

Du suchst ein Profil per E-Mail, erstellst es unter deiner Profilgruppe und passt demografische Daten später an.

Tests

GET /profiles

PATCH /profiles/{id}

Termine · 15 Endpunkte

Ein Termin umfasst die Panels und die Blutabnahme

Fünfzehn Endpunkte decken die Buchung und alle späteren Änderungen ab, einschließlich Panels, Behältervorschauen und Bestätigung.

Tests

POST /appointments

GET /appointments/{id}/results

Bestellungen von Heimkits · 10 Endpunkte

Heimkit-Bestellungen sind die Postversion

Zehn Endpunkte fordern ein DIY-Kit für ein Profil an, ändern dessen Panels und liefern das gleiche Ergebnisformat.

Tests

Kit-Bestellung erstellen

Ergebnisse abrufen

Standorte · 2 Endpunkte

Standorte zeigen dir, wo eine Blutabnahme stattfindet

Du liest die Standorte aus, die dein Schlüssel buchen kann, und fragst einen davon nach den verfügbaren Startzeiten.

Tests

GET /locations

GET /locations/{id}/availability

Dokumente · 1 Endpunkt

Ergebnisse werden als klinische und genetische Zeilen ausgegeben

Jeder Bestellentyp hat seinen eigenen Ergebnis-Aufruf und der PDF-Bericht ist ein separater Download nach Datei-ID.

Tests

GET /appointments/{id}/results

GET /documents/{id}

Sendungen · 8 Endpunkte

Ein Kurier bringt die Probe ins Labor

Du erstellst einen Kurierauftrag mit einem Abholzeitfenster unter der Woche, verknüpfst Termine und liest den Status ab.

Tests

POST /shipments

Termine verknüpfen

Kataloge · 4 Endpunkte

Kataloge zeigen die bestellbaren Biomarker

Die Biomarker-, Panel- und Einheitenkataloge sind seitenbasiert und du kannst Biomarker nach Testort filtern.

Tests

GET /biomarkers

GET /panels

Gesundheit · 1 Endpunkt

Ein Bereitschaftsendpunkt benötigt keinen API-Schlüssel

Die Bereitschaftssonde braucht keinen API-Schlüssel, sodass dein Überwachungstool sie regelmäßig abrufen kann.

Tests

Öffentliche Bereitschaftssonde

Deine Arbeit endet mit der Barcode-Bestätigung

Die Laborpipeline startet, wenn du die Blutabnahme bestätigst

Du schickst uns den Barcode des Kits, und das ist das Letzte, was wir von dir brauchen. Wir kümmern uns um die Behälter, den Kurier und das Labor, sodass dein Code bis zur Fertigstellung des Berichts nur zwei Endpunkte aufrufen muss.

Ein ausgefüllter Punkt ist die Route, die du möchtest.Ein Kreis ist ein Status, den du noch bearbeitest.Orangetane Linien sind die bestätigte Bestellung.

Ein Parser verarbeitet eine Praxis-Blutabnahme und ein Heimtest-Set

Jedes Ergebnis hat zwei Referenzbereiche und vier Status

Jede klinische Zeile enthält den vom Labor angegebenen Bereich und den Aniva Bereich mit seinem Optimal-Fenster, sodass du beides anzeigen kannst, ohne eine eigene Nachschlagetabelle zu führen.

Ein Eintrag lautet „geplant“, bevor das Labor ihn analysiert.

Ein Eintrag lautet „erhalten“, sobald ein Wert und eine Einheit vorliegen.

Eine Zeile gilt als Fehler, wenn das Labor die Anfrage storniert hat, und status_reason erklärt den Grund.

GET /api/v1/appointments/{id}/results

{
  "status": "in_progress",
  "clinical_results": [{
    "status": "received",
    "biomarker_name": "Vitamin D",
    "value": 38.5, "unit": "ng/mL",
    "reference_range_lab": { "normal_min": 30, "normal_max": 100 },
    "reference_range_aniva": { "optimal_min": 40, "optimal_max": 60 },
    "tested_at": "2026-04-05"
  }],
  "documents": [{ "file_name": "lab-report-2026-04-05.pdf" }]
}

Die API verwendet drei Zeitformate.

Datumsangaben benötigen eine Zeitzone, sonst schlägt die Anfrage fehl

Ein Datum ohne Zeitangabe wird mit 400 abgelehnt – der häufigste Fehler bei ersten Integrationen.

Zeitstempel werden immer in UTC im ISO-8601-Format mit dem Z-Suffix zurückgegeben.

Eingaben müssen einen expliziten Offset enthalten, daher akzeptiert eine Buchung 2026-05-15T12:30:00+02:00.

Versandupdates behalten den vom Logistikanbieter gemeldeten Offset bei.

Kalenderfelder sind reine Ortszeitangaben wie etwa das Geburtsdatum.

Aniva vergibt und rotiert jeden Partnerschlüssel

Jede Anfrage erfordert deinen Partner-API-Schlüssel.

Die Authentifizierung verwendet den x-api-key-Header bei jedem Aufruf; ein fehlender oder ungültiger Schlüssel gibt 403 mit einem kurzen JSON-Fehler zurück.

Dein Schlüssel bestimmt, welche Standorte, Termine und Sendungen du sehen kannst.

Gib deinen API-Schlüssel niemals in clientseitigem Code oder öffentlichen Repositories preis.

Eine öffentliche Testabfrage benötigt keinen API-Schlüssel

Du kannst jeden Dienst auf der Statusseite verfolgen

Die Statusseite zeigt den aktuellen Status und den Verlauf der letzten 90 Tage für jeden Dienst. Dieselben Daten sind auch als JSON für dein eigenes Monitoring verfügbar.

Statusseite öffnen

Partnerschlüssel werden von unserem Team vergeben

Frage noch heute einen Partnerschlüssel bei uns an

Sag uns, in welchen Märkten du verkaufst und welche Tests du brauchst, wir schicken dir dann einen Schlüssel mit den passenden Rechten.

API-Schlüssel anfordern

Dokumentation lesen

Du kannst auch die OpenAPI-Datei herunterladen.

Diese Seite ist ein Design-Mockup. Jeder Endpunkt und Payload darauf stammt von docs.anivahealth.com und das Diagramm dient zur Veranschaulichung.

Maschinenlesbare Kopien der Dokumentation findest du unter docs.anivahealth.com/llms.txt und docs.anivahealth.com/llms-full.txt.