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

> Wijzig afspraakgegevens voor de bloedafname

Werk afspraakgegevens bij, zoals het geplande tijdstip of de testlocatie. Alleen afspraken waarvan de bloedafname nog niet is bevestigd, kunnen worden gewijzigd.

> [!WARNING]
>
> Afspraken kunnen niet worden gewijzigd nadat de bloedafname is bevestigd of als ze al zijn
> geannuleerd. Een poging om zo'n afspraak bij te werken geeft `409 Conflict` terug. De enige
> uitzondering is `results_ready_emails`, dat je na de bloedafname nog kunt aanpassen.

Vereist de scope `appointments_schedule` of `appointments_manage`.

## Verzoek

### Padparameters

**id** `string` *required*

Unieke identifier (UUID) van de afspraak die je wilt bijwerken.

### Bodyparameters

Alle bodyparameters zijn optioneel — neem alleen de velden op die je wilt wijzigen.

**scheduled\_at** `string`

Nieuwe datum en tijd van de afspraak in ISO 8601-formaat (bijv. `2026-05-20T14:00:00Z` of
`2026-05-20T16:00:00+02:00`). **Moet een tijdzone-aanduiding bevatten** — ofwel `Z` of een
expliciete offset zoals `+02:00`; naïeve datum-tijden worden geweigerd. Moet in de toekomst liggen.

Moet een exacte starttijd van een tijdslot met resterende capaciteit zijn — zie
[Beschikbaarheid ophalen](https://docs.anivahealth.com/nl/api/locations/get-availability.md). De afspraak die wordt verzet telt nooit
mee voor het eigen doeltijdslot, maar verplaatsen naar een tijdslot waarop hetzelfde profiel al een
*andere* afspraak heeft, geeft `409` terug met de `appointment_id` van die afspraak.

Als de *beoogde* locatie door Aniva wordt beheerd, moet het nieuwe tijdstip ook minimaal 12 uur vooruit
liggen — zie [Minimale termijn](https://docs.anivahealth.com/nl/api/appointments/create-appointment.md#minimale-boekingstermijn).

**location\_id** `string`

UUID van de nieuwe testlocatie. De locatie moet bestaan en actief zijn. Gebruik [Locaties
ophalen](https://docs.anivahealth.com/nl/api/locations/list-locations.md) om beschikbare locatie-ID's te vinden.

**results\_ready\_emails** `string[]`

Vervangt de lijst van maximaal 5 adressen die elk één e-mail krijgen zodra alle labresultaten
definitief zijn. Stuur `[]` om de e-mails uit te zetten. Dit veld blijft bewerkbaar na de
bloedafname; alleen een geannuleerde afspraak weigert het. Stuur het na de bloedafname apart: met
`scheduled_at` of `location_id` in dezelfde body geeft het verzoek `409` terug. Je sleutel heeft
`results_view`-toegang tot de patiënt nodig, anders `403`. Zie
[E-mails wanneer resultaten klaarstaan](https://docs.anivahealth.com/nl/concepts/results.md#e-mails-zodra-resultaten-klaarstaan).

**draw\_method** `string | null`

Nieuwe afnamemethode: `capillary` of `venous`, of `null` om weer de `default_draw_method` van de
locatie te gebruiken. De locatie moet de methode in `draw_methods` hebben staan en de geboekte
tests moeten ermee mogelijk zijn, anders `400`. Wanneer je een afspraak naar een andere locatie
verplaatst, wordt daar dezelfde controle uitgevoerd: op de eigen `draw_method`, anders op de
`default_draw_method` van de nieuwe locatie.

## Respons

Bij succes geeft de API `200 OK` terug met de bijgewerkte afspraak en het ingesloten profiel.

**id** `string` *required*

Unieke afspraak-identifier (UUID).

**profile\_id** `string` *required*

UUID van het profiel waarbij deze afspraak hoort.

**location\_id** `string`

UUID van de testlocatie waar de bloedafname plaatsvindt.

**scheduled\_at** `string`

Geplande datum en tijd van de afspraak als UTC-tijdstip (ISO 8601 met `Z`-achtervoegsel, bijv.
`2026-05-20T14:00:00Z`). Kan `null` zijn.

**status** `string` *required*

Huidige status van de afspraak. Een van `pending`, `confirmed`, `blood_drawn` of `cancelled`.
De gedetailleerde voortgang van labresultaten leid je af uit [Resultaten ophalen](https://docs.anivahealth.com/nl/api/appointments/get-results.md);
de verdere voortgang van zendingen uit elk item in de inline `shipments`-array (zie hieronder)
door deze op te vragen via [Zending ophalen](https://docs.anivahealth.com/nl/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Vrije tekst als reden die is vastgelegd bij het annuleren van de afspraak (bijv. no-show, late annulering,
'Mislukt. Herhaling vereist'). `null` tenzij `status` gelijk is aan `cancelled`.

**results\_ready\_emails** `string[]` *required*

E-mailadressen die elk één e-mail krijgen zodra alle labresultaten definitief zijn, in kleine letters. Leeg wanneer uitgeschakeld. Zie
[E-mails bij beschikbare resultaten](https://docs.anivahealth.com/nl/concepts/results.md#e-mails-zodra-resultaten-klaarstaan).

**draw\_method** `string` *required*

Hoe het bloed wordt afgenomen: `capillary` (vingertop of bovenarm, in microtainers) of `venous` (uit de ader,
in buisjes). Dit is de methode die de afspraak instelt, anders de `default_draw_method` van de
[locatie](https://docs.anivahealth.com/nl/concepts/locations.md). Na de bloedafname is dit de methode die is gebruikt.

**created\_at** `string` *required*

ISO 8601-tijdstempel van wanneer de afspraak is aangemaakt.

**updated\_at** `string`

ISO 8601-tijdstempel van de laatste update. Kan `null` zijn.

**profile** `object` *required*

Het patiëntprofiel dat bij deze afspraak hoort.

**profiel**

**id** `string`

Unieke profiel-identifier (UUID).

**handle** `string`

Profielhandle of gebruikersnaam. Kan `null` zijn.

**first\_name** `string`

Voornaam. Kan `null` zijn.

**last\_name** `string`

Achternaam. Kan `null` zijn.

**email** `string`

E-mailadres. Kan `null` zijn.

**phone** `string`

Telefoonnummer in E.164-formaat. Kan `null` zijn.

**sex** `integer`

Biologisch geslacht volgens ISO/IEC 5218. Kan `null` zijn.

**date\_of\_birth** `string`

Geboortedatum in `YYYY-MM-DD`-formaat. Kan `null` zijn.

**height** `number`

Lengte in centimeters. Kan `null` zijn.

**weight** `number`

Gewicht in kilogrammen. Kan `null` zijn.

**language** `string`

Voorkeurstaal: een van de 32 codes in [Profiel aanmaken](https://docs.anivahealth.com/nl/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Of dit profiel transactionele (programmatische) e-mails ontvangt. Kan `null` zijn.

**created\_at** `string`

ISO 8601-tijdstempel van wanneer het profiel is aangemaakt.

**updated\_at** `string`

ISO 8601-tijdstempel van de laatste profielupdate. Kan `null` zijn.

**panels** `AppointmentPanel[]` *required*

Panels die momenteel aan deze afspraak zijn gekoppeld. Geannuleerde koppelingen zijn uitgesloten. Zoek details van een panel
(naam, biomarkers) op via [Panels weergeven](https://docs.anivahealth.com/nl/api/panels/list-panels.md).

**Velden voor gekoppeld panel**

**panel\_id** `string`

Panel-UUID — zoek op via [Panels opvragen](https://docs.anivahealth.com/nl/api/panels/list-panels.md).

**added\_at** `string`

ISO 8601-tijdstempel waarop het panel voor het eerst aan deze afspraak werd gekoppeld.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

À-la-carte biomarkers die los van een panel aan deze afspraak zijn gekoppeld (zie [Aangepaste
biomarkers toevoegen](https://docs.anivahealth.com/nl/api/appointments/add-individual-biomarkers.md)). Zoek elke `biomarker_id` op
via [Biomarkers opvragen](https://docs.anivahealth.com/nl/api/biomarkers/list-biomarkers.md) voor weergavegegevens.

**Velden voor individuele biomarker**

**biomarker\_id** `integer`

Biomarker-identifier — zoek op via
[Biomarkers opvragen](https://docs.anivahealth.com/nl/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO 8601-tijdstempel waarop de biomarker voor het eerst aan deze afspraak werd gekoppeld.

**shipments** `AppointmentShipmentLink[]` *required*

Zendingen gekoppeld aan deze afspraak, met de oudste koppeling eerst. Lege array wanneer er geen
zendingen zijn gekoppeld. Gebruik elke `id` bij [Zending ophalen](https://docs.anivahealth.com/nl/api/shipments/get-shipment.md)
voor de volledige zendingspayload.

**Velden voor zendingkoppeling**

**id** `string`

Zendingreferentie-identifier — zoek op via
[Zending ophalen](https://docs.anivahealth.com/nl/api/shipments/get-shipment.md).

**added\_at** `string`

ISO 8601-tijdstempel waarop de zending voor het eerst aan deze afspraak werd gekoppeld.

**lab\_codes** `string[]` *required*

Labcodes (barcodes op de buisjes) die voor deze afspraak zijn vastgelegd, in scanvolgorde. Leeg totdat de bloedafname
is bevestigd. Een veneuze bloedafname heeft één code die op elk buisje staat gedrukt; een capillaire bloedafname heeft één
code per microtainer. Resultaten en documenten op [Resultaten ophalen](https://docs.anivahealth.com/nl/api/appointments/get-results.md) verwijzen
naar deze codes via `lab_code`.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Validatiefout — bijv. `scheduled_at` ligt in het verleden, is minder dan 12 uur van tevoren op een door Aniva beheerde locatie, ongeldig UUID-formaat, de locatie heeft geen afnamematerialen op voorraad voor de `draw_method`, of de geboekte tests zijn niet mogelijk met de `draw_method`. |
| `403` | Geen toegang — je API-sleutel heeft geen toegang tot deze bewerking, de afspraak of locatie valt buiten je toegangscontext, of `results_ready_emails` is ingesteld zonder `results_view`-toegang tot de patiënt. |
| `404` | Afspraak of locatie niet gevonden. |
| `409` | Afspraak kan niet worden gewijzigd (bloedafname is al bevestigd of afspraak is geannuleerd), het gekozen tijdslot zit vol, de locatie is op die datum gesloten, of dit profiel heeft al een andere afspraak op de gekozen locatie en tijd (bevat `appointment_id`). |
| `500` | Interne serverfout. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "scheduled_at": "2026-05-20T14:00:00Z",
    "location_id": "d8f3e1a2-4c5b-6d7e-8f9a-0b1c2d3e4f5a"
  }'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "d8f3e1a2-4c5b-6d7e-8f9a-0b1c2d3e4f5a",
  "scheduled_at": "2026-05-20T14:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": "2026-04-10T11:30:00Z",
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

```json 409 theme={null}
{
  "error": "Appointment cannot be modified after blood draw has been confirmed"
}
```

```json 404 theme={null}
{
  "error": "Location not found or inactive"
}
```


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