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

# Profielen

> Hoe patiëntprofielen werken in de Aniva Partner API: personen aanmaken, bijwerken en koppelen voor wie je bloedtests en thuistestkits boekt.

Een profiel is een record dat een patiënt of gebruiker in het Aniva-systeem vertegenwoordigt. Elke afspraak, laboratoriumorder en elk resultaat is gekoppeld aan een profiel.

## Profielgroepen

Wanneer je een profiel aanmaakt, wijs je het toe aan een **profielgroep** via de parameter `profile_group`. Een profielgroep ordent profielen onder je partneraccount en bakent ze af voor een specifiek programma of een specifieke integratie.

Het veld `profile_group` accepteert de onveranderlijke UUID van de groep of de leesbare slug. De UUID is de duurzame referentie — deze verandert nooit en blijft geldig als de slug wordt hernoemd. De slug is bedoeld voor leesbare URL's en partnerintegraties.

Een waarde voor `profile_group` (UUID of slug) is verplicht bij het aanmaken. Het oudere veld `profile_group_slug` blijft geaccepteerd als verouderde alias.

## Velden

**id** `string` *required*

Automatisch door Aniva gegenereerde UUID. Gebruik deze om in andere API-calls naar het profiel te
verwijzen.

**handle** `string`

Een optionele gebruikersnaam of handle voor het profiel. Kan null zijn.

**first\_name** `string`

Voornaam van de patiënt. Alleen Latijnse tekens, 1–100 tekens. Verplicht bij het aanmaken.

**last\_name** `string`

Achternaam van de patiënt. Alleen Latijnse tekens, 1–100 tekens. Verplicht bij het aanmaken —
laboratoria weigeren orders voor een patiënt zonder achternaam. Kan null zijn bij profielen die
zijn aangemaakt voordat dit verplicht werd.

**email** `string`

E-mailadres van de patiënt. Als je er geen opgeeft bij het aanmaken, genereert Aniva automatisch
een placeholder-e-mailadres.

**phone** `string`

Telefoonnummer in [E.164-formaat](https://www.itu.int/rec/T-REC-E.164/en) (bijv. `+14155552671`).
Kan null zijn.

**sex** `integer`

Biologisch geslacht volgens [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `1` = man,
`2` = vrouw. Verplicht bij het aanmaken, tenzij je profielgroep de patiënt dit zelf laat invullen
(zie hieronder). Het laboratorium heeft dit nodig voor de referentiebereiken, dus aanmaken of
bijwerken met `0` (onbekend) geeft `400` terug. Profielen die vóór 30 september 2026 zijn
aangemaakt kunnen nog `0` teruggeven.

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

Geboortedatum in het formaat `YYYY-MM-DD`. Verplicht bij het aanmaken, tenzij je profielgroep de
patiënt dit zelf laat invullen (zie hieronder). Moet in het verleden liggen, niet vóór 1900, en
neerkomen op een leeftijd tussen 16 en 100 jaar; onwaarschijnlijke waarden worden geweigerd met
`400`. De geboortedatum wordt met de order naar het laboratorium gestuurd en kan niet meer worden
gewijzigd zodra de order is geplaatst.

**height** `number`

Lengte in centimeters. Kan null zijn.

**weight** `number`

Gewicht in kilogram. Kan null zijn.

**language** `string`

Voorkeurstaal voor communicatie richting de patiënt. Geaccepteerde waarden: `en`, `de`, `fi`.

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

Of het profiel transactionele e-mails ontvangt, zoals afspraakbevestigingen en meldingen wanneer
resultaten klaarstaan. Staat los van marketing-opt-in. Null als dit nooit is ingesteld.

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

ISO 8601-tijdstempel van het moment waarop het profiel is aangemaakt.

**updated\_at** `string`

ISO 8601-tijdstempel van de meest recente update. Null als het profiel nooit is bijgewerkt.

> [!NOTE]
>
> De velden `first_name`, `last_name`, `sex`, `date_of_birth` en `profile_group` zijn verplicht bij
> het aanmaken van een profiel. Alle andere velden zijn optioneel. Het oudere veld
> `profile_group_slug` wordt nog geaccepteerd als verouderde alias voor `profile_group`.

### De patiënt zelf geboortedatum en geslacht laten invullen

We kunnen één instelling voor je profielgroep inschakelen. Dan kun je een profiel aanmaken zonder
`date_of_birth` en `sex`. Vraag ons om dit in te schakelen. Zonder deze instelling geeft het
aanmaken zonder een van beide velden `400` terug.

De patiënt vult beide in op de activatiepagina van de kit (`anivahealth.com/activate`), samen met
de kitcode. De pagina vraagt twee keer om de geboortedatum, omdat het laboratorium deze later niet
kan wijzigen. Daarna kan de kit alleen met die geboortedatum worden geopend. Totdat de patiënt
beide heeft ingevuld, houden we de laboratoriumorder vast. Gebruik deze instelling alleen voor
thuistestkits.

## Levenscyclus

Profielen volgen een eenvoudige levenscyclus:

1. **Aanmaken** — registreer het profiel met de verplichte demografische velden en een `profile_group` (UUID
   of slug).
2. **Bijwerken** (optioneel) — voeg velden toe of wijzig ze, zoals `phone`, `height` of `weight`.
3. **Koppelen** — koppel het profiel aan afspraken met de `id` ervan als `profile_id`.

Een `profile.*`-[webhook](https://docs.anivahealth.com/nl/concepts/webhooks.md) laat je weten wanneer een profiel verschijnt, verandert of wordt verwijderd.

## Voorbeeldprofiel

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "handle": "jdoe42",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "phone": "+14155552671",
  "sex": 2,
  "date_of_birth": "1990-06-15",
  "height": 168.0,
  "weight": 65.0,
  "language": "en",
  "transactional_emails_enabled": true,
  "created_at": "2026-03-01T09:00:00Z",
  "updated_at": "2026-03-10T14:32:00Z"
}
```


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