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

# Introductie

> Overzicht van de Aniva Partner API, een REST API voor bloedtests bij apotheken en praktijken, thuistestkits en labresultaten.

De Aniva Partner API is een REST API waarmee zorgpartners patiëntprofielen beheren, afspraken voor bloedafname op testlocaties inplannen en laborderpipelines starten. Je communiceert met de API via HTTPS met je partner-API-sleutel.

## Wat je kunt doen

* **Profielbeheer** — Maak demografische patiëntprofielen aan, haal ze op en werk ze bij.
* **Afspraken inplannen** — Plan afspraken voor bloedafname in op testlocaties van Aniva.
* **Panelbeheer** — Voeg labtestpanels toe aan een bestaande afspraak of verwijder ze.
* **Losse biomarkers** — Koppel losse biomarkers aan een afspraak of ontkoppel ze zonder een panel te kiezen.
* **Thuistestkit-bestellingen** — Stuur een thuistestkit per post naar een patiënt, volg de pakketten en meld wanneer het monster is afgenomen.
* **Panelcatalogus** — Bekijk beschikbare panels met `GET /api/v1/panels` om panel-ID's en de bijbehorende biomarkers te vinden.
* **Biomarkercatalogus** — Bekijk met `GET /api/v1/biomarkers` de biomarkers die je op een locatie of in een thuistestkit kunt bestellen om de ID's te vinden.
* **Bevestiging van bloedafname** — Stuur na een bloedafname de labcode(s) in om de laborderpipeline te starten.
* **Labresultaten** — Haal klinische en genetische resultaten op en download pdf's van labrapporten.
* **Locaties opzoeken** — Haal een overzicht op van beschikbare testlocaties om aan patiënten te tonen.
* **Verzendlogistiek** — Maak koerierszendingen aan, volg ze, pas ze aan en annuleer ze.
* **Webhooks** — Ontvang een HTTPS-aanroep wanneer een afspraak, een thuistestkit-bestelling, de resultaten ervan, een locatie, een profiel of een zending verandert. Zie [Webhooks](https://docs.anivahealth.com/nl/concepts/webhooks.md).

## Verken de documentatie

> [card] [Authenticatie](https://docs.anivahealth.com/nl/authentication.md)
>
> Authenticeer verzoeken met je partner-API-sleutel.

> [card] [Snelstartgids](https://docs.anivahealth.com/nl/quickstart.md)
>
> Doe je eerste API-aanroep in een paar minuten met stapsgewijze voorbeelden.

> [card] [Profielen](https://docs.anivahealth.com/nl/concepts/profiles.md)
>
> Lees hoe patiëntprofielen werken en welke gegevens ze bevatten.

> [card] [Afspraken](https://docs.anivahealth.com/nl/concepts/appointments.md)
>
> Begrijp de levenscyclus van een afspraak, van inplannen tot bevestiging.

> [card] [Thuistestkit-bestellingen](https://docs.anivahealth.com/nl/concepts/home-kit-orders.md)
>
> Stuur een testkit naar een patiënt thuis en volg deze tot het monster het lab bereikt.

## API-versiebeheer

De huidige API-versie is **v1**. Alle endpoints beginnen met `/api/v1/`. De basis-URL is `https://anivahealth.com`.

```text theme={null}
https://anivahealth.com/api/v1/
```

Breaking changes worden onder een nieuwe versieprefix geïntroduceerd. De v1-API blijft beschikbaar en eventuele uitfaseringen worden vooraf aangekondigd.

## Datums en tijdzones

Alle tijdstippen in het dataverkeer zijn **UTC ISO 8601** (`Z`-achtervoegsel). Kalendervelden gebruiken **kloktijd-
waarden** (`YYYY-MM-DD`, `HH:MM`).

| Categorie | Formaat | Gebruikt voor |
| - | - | - |
| **Tijdstip** | ISO 8601 in UTC (`Z`-achtervoegsel, bijv. `2026-04-15T08:30:00Z`) | Elke datum-tijd in de uitvoer — afspraak `scheduled_at`, beschikbaarheid `slots[]`, zending `pickup.from` / `pickup.till`, `created_at`, `updated_at`, `added_at`. Geef client-side weer in een lokale tijdzone naar keuze. |
| **Providergebeurtenis** | ISO 8601 met de offset van de upstream-provider (ongewijzigd doorgegeven) | Alleen `status_updates[].time` van zendingen — de offset geeft weer wat de koerier heeft gemeld. |
| **Kloktijd** | `YYYY-MM-DD` voor datums, `HH:MM` voor tijden — geen offset | Kalender- of tijdswaarden zonder tijdzone — `date_of_birth`, resultaten `tested_at`, beschikbaarheid `start_date` / `end_date`, zending `pickup_date` / `pickup_time_from` / `pickup_time_till`, locatie `open_hours`. |

Specifieke opmerkingen:

* **Invoervelden met een datum-tijd** (bijv. `scheduled_at` bij `POST` / `PATCH /api/v1/appointments`)
  **moeten een tijdzone-aanduiding bevatten** — ofwel `Z` of een expliciete offset zoals `+02:00`. Naïeve
  datum-tijden worden afgewezen met `400`. Beide vormen coderen hetzelfde tijdstip; het antwoord geeft
  `scheduled_at` altijd weer als UTC `Z`. Gebruik het veld `timezone` van de locatie (of een andere IANA-
  identifier) om het tijdstip bij weergave om te zetten naar lokale kloktijd.
* **Kloktijd-invoer** wordt geïnterpreteerd in de tijdzone van de resource waarop deze betrekking heeft: beschikbaarheidsdatums
  gebruiken de queryparameter `timezone` (standaard de tijdzone van de locatie); `pickup_date` /
  `pickup_time_*` van een zending worden geïnterpreteerd in de tijdzone van de herkomstlocatie.
* **Antwoordvelden met alleen een datum** (bijv. `tested_at`, beschikbaarheid `availability[].date`) zijn
  kalenderdatums zonder tijdzone.

## Toegang krijgen

API-sleutels worden per partner uitgegeven door Aniva.

> [!NOTE]
>
> Neem contact op met Aniva om je partner-API-sleutel te ontvangen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.