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

# Afspraak inplannen

> Stappenplan: vind een testlocatie, controleer de beschikbaarheid en boek een afspraak voor bloedafname met de Aniva API.

Met deze handleiding vind je een testlocatie, maak je een afspraak aan voor een patiëntprofiel en koppel je de uit te voeren testpanels. Voltooi deze stappen voordat de patiënt voor de bloedafname komt.

**1. Beschikbare locaties bekijken**

Haal de lijst met testlocaties op die beschikbaar zijn op je account met een `GET`-verzoek naar `/api/v1/locations`.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/locations', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
  },
});

const locations = await response.json();
```

De response is een array met locatieobjecten:

```json theme={null}
[
  {
    "id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Friedrichstraße",
    "house_number": "112",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": null,
    "image_url": null,
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "17:00" }],
      "tuesday": [{ "open": "08:00", "close": "17:00" }],
      "wednesday": [{ "open": "08:00", "close": "17:00" }],
      "thursday": [{ "open": "08:00", "close": "17:00" }],
      "friday": [{ "open": "08:00", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

> [!TIP]
>
> Gebruik het veld `timezone` uit het locatieobject wanneer je het tijdstip voor `scheduled_at` samenstelt. Door de afspraaktijd om te rekenen naar de lokale tijdzone van de locatie voorkom je dat je buiten de openingstijden plant.

> [!WARNING]
>
> Leid boekbare tijden niet alleen af uit `open_hours`. Roep [Beschikbaarheid ophalen](https://docs.anivahealth.com/nl/api/locations/get-availability.md) aan en boek een starttijd die daaruit terugkomt — dat rooster houdt ook rekening met bestaande boekingen, uitzonderingen per datum en de minimale boekingstermijn.

**2. De afspraak aanmaken**

Stuur een `POST`-verzoek naar `/api/v1/appointments` met de profiel-ID, locatie-ID en de gewenste afspraaktijd. De tijd moet een starttijd zijn uit [Beschikbaarheid ophalen](https://docs.anivahealth.com/nl/api/locations/get-availability.md).

> [!NOTE]
>
> `scheduled_at` moet een toekomstige datum en tijd in ISO 8601-formaat zijn, bijvoorbeeld `2026-05-12T07:30:00Z`. Tijdstippen in het verleden worden geweigerd met een `400`-fout, net als tijden binnen de [minimale boekingstermijn van 12 uur](https://docs.anivahealth.com/nl/api/appointments/create-appointment.md#minimale-boekingstermijn) op locaties die door Aniva worden beheerd.

> [!TIP]
>
> Dit verzoek herhalen is veilig. Een profiel kan maar één afspraak per locatie en tijdstip hebben, dus een opnieuw of dubbel verstuurd aanmaakverzoek geeft `409` terug met de bestaande `appointment_id` in plaats van de patiënt twee keer te boeken.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "scheduled_at": "2026-05-12T07:30:00Z"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/appointments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    profile_id: 'a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
    location_id: 'b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421',
    scheduled_at: '2026-05-12T07:30:00Z',
  }),
});

const appointment = await response.json();
```

Een geslaagd verzoek geeft `201 Created` terug met het afspraakobject:

```json theme={null}
{
  "id": "c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12",
  "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
  "scheduled_at": "2026-05-12T07:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T11:02:47Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "handle": null,
    "first_name": "Emma",
    "last_name": "Müller",
    "email": "emma.muller@example.com",
    "phone": null,
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "de",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T09:14:22Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Bewaar de `id` van de afspraak — je hebt deze nodig om panels toe te voegen en de bloedafname te bevestigen.

**3. Testpanels toevoegen**

Koppel de testpanels die je op het bloedmonster wilt laten uitvoeren met een `POST`-verzoek naar `/api/v1/appointments/{id}/panels`.

Panel-ID's zijn UUID's. Roep [Panels ophalen](https://docs.anivahealth.com/nl/api/panels/list-panels.md) aan om de panels te zien die je API-sleutel kan bestellen.

> [!WARNING]
>
> Panels kunnen niet meer worden toegevoegd nadat de bloedafname is bevestigd. Voeg alle benodigde panels vóór de bevestiging toe — zie [Bloedafname bevestigen](https://docs.anivahealth.com/nl/guides/confirm-blood-draw.md) voor details.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "panel_ids": [
      "d1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27",
      "e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38"
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      panel_ids: [
        'd1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27',
        'e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38',
      ],
    }),
  }
);

const result = await response.json();
```

Een geslaagd verzoek geeft `200 OK` terug als bevestiging dat de panels zijn toegevoegd:

```json theme={null}
{
  "success": true
}
```

## Verzetten of annuleren

Nadat je een afspraak hebt aangemaakt, kun je deze nog aanpassen voordat de bloedafname is bevestigd:

* **Verzetten of locatie wijzigen** — Stuur een `PATCH`-verzoek naar `/api/v1/appointments/{id}` met de velden die je wilt bijwerken. Zie [Afspraak bijwerken](https://docs.anivahealth.com/nl/api/appointments/update-appointment.md).
* **Annuleren** — Stuur een `DELETE`-verzoek naar `/api/v1/appointments/{id}`. Zie [Afspraak annuleren](https://docs.anivahealth.com/nl/api/appointments/cancel-appointment.md).

> [!NOTE]
>
> Beide bewerkingen zijn alleen beschikbaar vóór de bloedafname — dus zolang de afspraak de status
> `pending` of `confirmed` heeft. Zodra de afspraak op `blood_drawn` staat, zijn er geen
> wijzigingen meer mogelijk.

## Foutafhandeling

| Status | Oorzaak | Oplossing |
| - | - | - |
| `400 Bad Request` | Een verplicht veld ontbreekt, `scheduled_at` ligt in het verleden, staat niet op het tijdslotrooster of valt binnen de minimale boekingstermijn van 12 uur, of `panel_ids` is leeg. | Bekijk de error body voor de validatiemelding en corrigeer het verzoek. Kies voor de minimale boekingstermijn een later tijdslot uit [Beschikbaarheid ophalen](https://docs.anivahealth.com/nl/api/locations/get-availability.md). |
| `403 Forbidden` | Je API-sleutel heeft geen toegang tot deze bewerking. | Neem contact op met Aniva om de rechten van je API-sleutel te controleren. |
| `404 Not Found` | De `profile_id` of `location_id` bestaat niet, of de afspraak-ID is ongeldig bij het toevoegen van panels. | Controleer of de ID's kloppen en bij je account horen. |
| `409 Conflict` | Je hebt geprobeerd panels toe te voegen aan of wijzigingen aan te brengen in een afspraak die al `blood_drawn` of `cancelled` is. | Na bevestiging zijn geen wijzigingen meer mogelijk. |
| `409 Conflict` | Dit profiel heeft al een afspraak op die locatie en dat tijdstip, of het tijdslot is vol. | Bij een dubbele boeking bevat de response de bestaande `appointment_id` — gebruik die afspraak in plaats van het opnieuw te proberen. Kies anders een ander tijdslot. |


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