Bloedtesten boeken vanuit je eigen product

Eén API-sleutel geeft je 45 endpoints, van boeking tot labresultaten

De Aniva Partner API boekt een bloedafname op meer dan 25 locaties in Duitsland, voegt panels toe aan die afspraak en geeft klinische en genetische resultaten terug als JSON. Elk verzoek heeft één header nodig en de basis-URL is in elke omgeving hetzelfde.

Wanneer je Aniva gebruikt

Gebruik Aniva wanneer je klanten een bloedtest moeten boeken
Gebruik de afspraak-endpoints voor een bloedafname in een kliniek en de thuistestkit-endpoints voor een kit per post.
Gebruik de resultaten-endpoints voor klinische rijen, genetische rijen en het pdf-rapport.
Gebruik de catalogus-endpoints om de biomarkers, panels en eenheden uit te lezen die Aniva verkoopt.
Gebruik de gedocumenteerde paden onder https://anivahealth.com/api/v1/ en verzin geen endpoints.
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"
  }'
De basisflow bestaat uit vier requests
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endpoints zijn vandaag gedocumenteerd en live

1

Authenticatie heeft maar één request-header nodig

v1

Elk pad begint met de v1-prefix

25+

Duitse locaties kunnen de bloedafname doen

Vier verzoeken vormen een werkende integratie

Vier verzoeken lopen van boeking tot labresultaten

Elk verzoek geeft de ID terug die het volgende verzoek nodig heeft, dus een basisintegratie bestaat uit vier verzoeken voordat je panels, herplanningen of koeriers toevoegt.

Stap 01 · GET /locations

Je haalt de locaties op die je sleutel kan boeken

De response geeft je elk adres, de openingstijden en de tijdzone, zodat een klant alleen tijdsloten ziet die bestaan.

Tests
Stap 02 · POST /profiles

Je maakt een profiel aan voor de klant

Een profiel heeft een naam, een geslachtscode, een geboortedatum en je profile_group nodig, die een UUID of je eigen slug accepteert.

Tests
Stap 03 · POST /appointments

Je boekt de afspraak op een gekozen tijdstip

Voor de boeking zijn het profiel-ID, het locatie-ID en een ISO 8601-datumtijd met bijbehorende offset of het Z-achtervoegsel nodig.

Tests
Stap 04 · POST /appointments/{id}/confirm

Je bevestigt de bloedafname met de barcode van de kit

Dit verzoek start de labopdracht en legt de afspraak vast, dus pas elk panel aan voordat je het verstuurt.

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"
  }'
Mogelijkheid

Elke resourcegroep is één REST-collectie

Je kunt een bloedafname bij een kliniek bestellen, of een thuistestkit per post. Beide komen terug in hetzelfde formaat, dus je schrijft de code die resultaten uitleest maar één keer.

Profielen · 4 endpoints

Een profiel is de persoon die je test

Je zoekt een profiel op via e-mail, maakt het aan onder je profielgroep en werkt de demografische gegevens later bij.

Tests
GET /profiles
PATCH /profiles/{id}
Afspraken · 15 endpoints

Een afspraak bevat de panels en de bloedafname

Vijftien endpoints dekken de boeking en elke latere wijziging daarvan, inclusief panels, containerpreviews en de bevestiging.

Tests
POST /appointments
GET /appointments/{id}/results
Thuistestkit-bestellingen · 10 endpoints

Bestellingen van thuistestkits zijn de versie per post

Tien endpoints vragen een thuistestkit voor een profiel aan, passen de panels ervan aan en geven dezelfde resultaatstructuur terug.

Tests
Kitbestelling aanmaken
Resultaten ontvangen
Locaties · 2 endpoints

Locaties laten je zien waar een bloedafname plaatsvindt

Je leest de locaties uit die je sleutel kan boeken en vraagt er vervolgens een om de boekbare starttijden.

Tests
GET /locations
GET /locations/{id}/availability
Documenten · 1 endpoint

Resultaten komen terug als klinische en genetische rijen

Elk ordertype heeft een eigen aanroep voor de resultaten, en het pdf-rapport is een aparte download via bestands-ID.

Tests
GET /appointments/{id}/results
GET /documents/{id}
Zendingen · 8 endpoints

Een koerier brengt het monster naar het laboratorium

Je maakt een koeriersopdracht aan met een ophaaltijdvak op een werkdag, koppelt afspraken en bekijkt de statusupdates.

Tests
POST /shipments
Afspraken koppelen
Catalogi · 4 endpoints

Catalogi tonen de biomarkers die je kunt bestellen

De catalogi voor biomarkers, panels en eenheden zijn gepagineerd, en je kunt biomarkers filteren op testlocatie.

Tests
GET /biomarkers
GET /panels
Health · 1 endpoint

Eén readiness-endpoint heeft geen API-key nodig

De readiness probe heeft geen API-sleutel nodig, zodat je uptime-monitor deze volgens een schema kan aanroepen.

Tests
Openbare gereedheidscontrole
Jouw werk eindigt bij de barcodebevestiging

Het labproces start zodra je de bloedafname bevestigt

Je stuurt ons de barcode van de kit, en dat is het laatste wat we van je nodig hebben. Wij regelen daarna de verpakkingen, de koerier en het laboratorium, zodat je code maar twee endpoints hoeft aan te roepen tot het rapport klaar is.

The Aniva lab pipeline from confirmation to results Confirming the draw is followed by container selection, courier collection and laboratory analysis, and each biomarker row then reads as planned, received or fault. POST /appointments/{id}/confirmYou confirm the draw GET /appointments/{id}/previewContainers are known POST /shipmentsA courier collects it Aniva laboratory networkThe laboratory analyses planned received fault GET /appointments/{id}/results
Een gevulde stip is de route die je wilt.Een ring is een status die je nog afhandelt.Oranje lijnen zijn de bevestigde bestelling.
Eén parser leest een bloedafname in de kliniek en een thuistestkit

Elk resultaat heeft twee referentiebereiken en vier statussen

Elke klinische rij bevat het bereik dat het laboratorium heeft gerapporteerd en het Aniva-bereik met het optimale venster, zodat je beide kunt weergeven zonder zelf een opzoektabel bij te houden.

Een rij toont gepland voordat het laboratorium deze analyseert.
Een rij krijgt de status ontvangen zodra een waarde en een eenheid terugkomen.
Een rij toont fault wanneer het laboratorium de aanvraag heeft geannuleerd, en status_reason legt uit waarom.
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" }]
}
De API gebruikt drie tijdformaten

Datum-tijdwaarden hebben een tijdzone nodig, anders mislukt het verzoek

Een naïeve datetime wordt afgewezen met 400, de fout die de meeste eerste integraties maken.

Tijdstempels komen altijd terug als UTC, volgens ISO 8601 met het achtervoegsel Z.
Invoer moet een expliciete offset bevatten, dus een boeking accepteert 2026-05-15T12:30:00+02:00.
Verzendupdates behouden de offset die de logistieke dienstverlener heeft gemeld.
Kalendervelden gebruiken alleen kloktijd, zoals een geboortedatum.
Aniva geeft elke partnersleutel uit en roteert deze

Voor elk verzoek is je partner-API-sleutel nodig

Authenticatie gebruikt bij elke aanroep de header x-api-key, en een ontbrekende of geroteerde sleutel geeft 403 terug met een korte JSON-foutmelding.

Je sleutel bepaalt welke locaties, afspraken en zendingen je kunt zien.
Stel je API-sleutel nooit bloot in client-side code of openbare repositories.
Een publieke probe heeft geen API-key nodig

Je kunt elke dienst volgen op de statuspagina

De statuspagina toont de actuele status en 90 dagen geschiedenis per dienst, en dezelfde gegevens zijn beschikbaar als JSON voor je eigen monitor.

Partnersleutels worden door ons team uitgegeven

Vandaag een partnersleutel bij ons aanvragen

Laat ons weten in welke markten je verkoopt en welke panels je nodig hebt, dan sturen we een sleutel met de juiste rechten.

Je kunt ook het OpenAPI-bestand downloaden

Deze pagina is een ontwerp-mockup. Elk endpoint en elke payload erop komt van docs.anivahealth.com en het pipelinediagram is illustratief.

Machineleesbare kopieën van de documentatie staan op docs.anivahealth.com/llms.txt en docs.anivahealth.com/llms-full.txt.