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

> Annuleer een afspraak voor bloedafname

Annuleer een afspraak door de status op `cancelled` te zetten. Alleen afspraken waarvan de bloedafname nog niet is bevestigd, kunnen worden geannuleerd.

Het annuleren van een afspraak die al `cancelled` is, geeft `200` terug met die afspraak en schrijft niets weg — er wordt geen tweede annulering vastgelegd. De response bevat `Idempotent-Replayed: true`, zodat je een herhaling kunt onderscheiden van de aanroep die het werk deed. Een herhaling met een **andere** `cancellation_reason` geeft in plaats daarvan `409` terug: de vastgelegde reden wordt nooit overschreven. Zie [Idempotentie](https://docs.anivahealth.com/nl/concepts/idempotency.md).

> [!WARNING]
>
> Afspraken kunnen niet meer worden geannuleerd nadat de bloedafname is bevestigd — dat geeft `409
>     Conflict` terug.

Vereist de scope `appointments_schedule` of `appointments_manage`.

## Verzoek

### Padparameters

**id** `string` *required*

Unieke identifier (UUID) van de te annuleren afspraak.

### Bodyparameters

De body is optioneel — stuur helemaal geen body mee om te annuleren zonder een reden vast te leggen.

**cancellation\_reason** `string`

Vrije tekst als reden voor de annulering, maximaal 500 tekens (bijv. `Patient no-show`). Wordt
opgeslagen bij de afspraak en teruggegeven als `cancellation_reason` bij deze en latere opvragingen.

## Respons

Bij succes geeft de API `200 OK` terug met de geannuleerde 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-15T10:30:00Z`). Kan `null` zijn.

**status** `string` *required*

Afspraakstatus. Is `cancelled` na een geslaagde annulering.

**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 vóór de annulering aan deze afspraak waren gekoppeld. Zoek paneldetails (naam,
biomarkers) op via [Panels opvragen](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 die vóór de annulering aan deze afspraak waren gekoppeld. Elke `id` verwijst naar
[Zending ophalen](https://docs.anivahealth.com/nl/api/shipments/get-shipment.md).

**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` | Ongeldig ID-formaat, of een ongeldige body / `cancellation_reason` langer dan 500 tekens. |
| `403` | Verboden — je API-sleutel heeft geen toegang tot deze bewerking of de afspraak valt buiten je toegangscontext. |
| `404` | Afspraak niet gevonden. |
| `409` | De bloedafname is al bevestigd, of de afspraak is al geannuleerd met een andere reden. |
| `500` | Interne serverfout. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY'
```

```bash cURL (with a reason) theme={null}
curl --request DELETE \
  --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 '{
    "cancellation_reason": "Patient no-show"
  }'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "cancelled",
  "cancellation_reason": "Patient no-show",
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": "2026-04-10T12:00: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": "This appointment is already cancelled with a different cancellation_reason. Re-send the recorded reason, or omit it, to read the cancelled appointment back."
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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