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

# Afspraken weergeven

> Haal afspraken voor bloedafname op die toegankelijk zijn voor je API-sleutel

Haal een lijst met afspraken voor bloedafname op. Elke afspraak bevat het ingesloten patiëntprofiel.

De filters zijn te combineren:

* `date` geeft de afspraken op één kalenderdag terug. De dag is de lokale dag van de locatie van elke afspraak, dus een bloedafname om 23:30 in Berlijn telt mee op de datum in Berlijn.
* `location_id` geeft de afspraken op één testlocatie terug.
* `profile_id` zonder `date` geeft alle afspraken voor dat profiel terug, zonder tijdslimiet.
* Zonder `profile_id` en zonder `date` geldt het standaard tijdvenster: de afgelopen 2 maanden tot 1 maand vooruit.

Vereist de scope `appointments_view` of `appointments_schedule`.

## Verzoek

### Queryparameters

**profile\_id** `string`

Filter op profiel-UUID. Als je deze opgeeft, worden alle afspraken voor dit profiel teruggegeven, ongeacht
de geplande datum. Als je deze weglaat, geldt het standaard tijdvenster.

**location\_id** `string`

Filter op UUID van de testlocatie.

**date** `string`

Kalenderdag in het formaat `YYYY-MM-DD`, in de tijdzone van de locatie van elke afspraak. Vervangt het
standaard tijdvenster. Resultaten worden gesorteerd op `scheduled_at`, vroegste eerst.

## Respons

Bij succes geeft de API `200 OK` terug met een array van afspraakobjecten.

**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*

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 die aan deze afspraak zijn gekoppeld, met de oudste koppeling eerst. Lege array als er geen zendingen zijn
gekoppeld. Zoek elke `id` op via [Zending ophalen](https://docs.anivahealth.com/nl/api/shipments/get-shipment.md) voor de
volledige payload van de zending (status, trackingnummer, statusupdates enz.).

**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`.

## Herhaalde aanroepen

Aniva slaat het antwoord van dit endpoint 5 minuten op per API-sleutel. Een herhaalde aanroep binnen
deze tijd krijgt het opgeslagen antwoord. De headers `Cache-Status` en `Age` laten zien dat het antwoord is
opgeslagen en hoe oud het is.

Om direct op de hoogte te zijn van een wijziging, abonneer je je op de webhook-events `appointment.created`, `appointment.rescheduled` en het event van elke status, bijvoorbeeld `appointment.confirmed`.
Zie [Herhaald ophalen](https://docs.anivahealth.com/nl/concepts/webhooks.md#herhaalde-leesverzoeken).

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Ongeldige queryparameter, bijvoorbeeld een `date` die niet in het formaat `YYYY-MM-DD` staat. |
| `403` | Verboden — je API-sleutel heeft geen toegang tot deze bewerking, of het opgevraagde profiel of de locatie valt buiten je machtigingsbereik. |
| `500` | Interne serverfout. |

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

```bash cURL (one day at one location) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/appointments?date=2026-10-21&location_id=b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b' \
  --header 'x-api-key: YOUR_API_KEY'
```

```bash cURL (by profile) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/appointments?profile_id=a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d' \
  --header 'x-api-key: YOUR_API_KEY'
```

```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": "confirmed",
    "cancellation_reason": null,
    "results_ready_emails": [],
    "draw_method": "venous",
    "created_at": "2026-04-01T09:45:00Z",
    "updated_at": null,
    "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": [
      {
        "biomarker_id": 42,
        "added_at": "2026-04-01T09:52:00Z"
      }
    ],
    "shipments": [
      {
        "id": "P2611194821",
        "added_at": "2026-04-15T07:00:00Z"
      }
    ],
    "lab_codes": []
  }
]
```

```json 403 theme={null}
{
  "error": "Access denied: profile is outside your permission scope"
}
```


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