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

> Haal een afspraak voor bloedafname op via ID

Haal één afspraak voor een bloedafname op via de UUID, inclusief het ingesloten patiëntprofiel. Gebruik dit endpoint om de status van de afspraak te controleren, planningsgegevens te bevestigen of de bijbehorende profielgegevens op te halen.

Vereist de scope `appointments_view` of `appointments_schedule`.

## Verzoek

### Padparameters

**id** `string` *required*

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

## Respons

Bij succes retourneert de API `200 OK` met de 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*

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 bewaart het antwoord van dit endpoint 15 minuten per API-sleutel. Een herhaalde aanroep binnen
deze tijd krijgt het bewaarde antwoord zolang de afspraak ongewijzigd is. Na een wijziging krijg je een nieuw
antwoord. De headers `Cache-Status` en `Age` laten zien dat het antwoord
bewaard is 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 ID-indeling — de opgegeven waarde is geen geldige UUID. |
| `403` | Geen toegang — je API-sleutel heeft geen toegang tot deze bewerking. |
| `404` | Afspraak niet gevonden. |
| `500` | Interne serverfout. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --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 400 theme={null}
{
  "error": "Invalid appointment ID format"
}
```

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


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