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

# Snelstart

> Doe in een paar minuten je eerste aanroep naar de Aniva Partner API: vind een testlocatie, maak een profiel aan en boek een bloedafname.

Deze gids neemt je mee door de basisworkflow: een testlocatie vinden, een patiëntprofiel aanmaken, een afspraak inplannen en een bloedafname bevestigen.

## Vereisten

Je hebt een partner-API-sleutel nodig die door Aniva is uitgegeven.

> [!NOTE]
>
> Als je nog geen API-sleutel hebt, neem dan contact op met Aniva om er een te laten uitgeven voor je partneraccount.

## Stappen

**1. Beschikbare locaties opvragen**

Haal de lijst met testlocaties op om een `location_id` te vinden voor de afspraak die je wilt inplannen.

```bash theme={null}
curl https://anivahealth.com/api/v1/locations \
  -H "x-api-key: YOUR_API_KEY"
```

**Voorbeeldantwoord**

```json theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": null,
    "image_url": null,
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

Noteer de `id` van de locatie die je wilt gebruiken. Je hebt deze nodig in stap 3.

**2. Een profiel aanmaken**

Maak een patiëntprofiel aan door de demografische gegevens van de patiënt te versturen. Met `profile_group` koppel je het profiel aan je partneraccount — dit veld accepteert de onveranderlijke UUID van de groep of de leesbare slug.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/profiles \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Rivera",
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "profile_group": "your-profile-group"
  }'
```

**Velden van de request body**

| Veld | Type | Verplicht | Beschrijving |
| - | - | - | - |
| `first_name` | string | Ja | Voornaam van de patiënt |
| `last_name` | string | Ja | Achternaam van de patiënt |
| `sex` | integer | Ja\*\* | `1` = man, `2` = vrouw (ISO/IEC 5218) |
| `date_of_birth` | string | Ja\*\* | Geboortedatum in het formaat `YYYY-MM-DD`. Moet in het verleden liggen, niet vóór 1900, en overeenkomen met een leeftijd van 16–100 jaar. |
| `profile_group` | string | Ja\* | UUID of slug van je partnerprofielgroep. De UUID is de stabiele referentie; een slug wordt ook geaccepteerd. |
| `profile_group_slug` | string | Nee | **Verouderd.** Slug-alias voor `profile_group`. Ofwel `profile_group` ofwel `profile_group_slug` is verplicht. |
| `email` | string | Nee | E-mailadres van de patiënt. Wordt automatisch gegenereerd als het wordt weggelaten. |
| `language` | string | Nee | `en`, `de` of `fi`. Standaard `en`. |
| `phone` | string | Nee | Telefoonnummer in E.164-formaat, bijvoorbeeld `+4915123456789`. |
| `height` | number | Nee | Lengte in centimeter. |
| `weight` | number | Nee | Gewicht in kilogram. |
| `transactional_emails_enabled` | boolean | Nee | Overschrijft de standaardinstelling van de profielgroep voor operationele e-mails. |
| `marketing_emails_enabled` | boolean | Nee | Overschrijft de standaardinstelling van de profielgroep voor marketing-e-mails. |

\*\* Optioneel wanneer je profielgroep de patiënt beide laat invullen op de activatiepagina van de kit. Zie
[Profielen](https://docs.anivahealth.com/nl/concepts/profiles.md#de-patient-zelf-geboortedatum-en-geslacht-laten-invullen).

**Voorbeeldantwoord (201 Created)**

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "handle": null,
  "first_name": "Jordan",
  "last_name": "Rivera",
  "email": "jordan.rivera@example.com",
  "phone": null,
  "sex": 1,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "en",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null
}
```

Noteer de `id` uit het antwoord. Je gebruikt deze als `profile_id` in de volgende stap.

**3. Een afspraak inplannen**

Maak een afspraak aan met de `profile_id` uit stap 2 en de `location_id` uit stap 1. Stel `scheduled_at` in op de begintijd van een tijdslot dat [Beschikbaarheid ophalen](https://docs.anivahealth.com/nl/api/locations/get-availability.md) voor die locatie teruggeeft. De API wijst een tijd af die niet op het tijdslotrooster ligt.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "scheduled_at": "2026-04-10T09:00:00Z"
  }'
```

**Voorbeeldantwoord (201 Created)**

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "scheduled_at": "2026-04-10T09:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T10:05:00Z",
  "updated_at": null,
  "profile": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "handle": null,
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": null,
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "en",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T10:00:00Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Noteer de `id` van de afspraak. Je gebruikt deze om de bloedafname te bevestigen.

**4. De bloedafname bevestigen**

Nadat de bloedafname is voltooid, stuur je de labcode (barcode op het buisje) in om de bloedafname te bevestigen en de laborderpipeline te starten. Bij een bloedafname waarvan de buisjes meerdere codes hebben, stuur je in plaats daarvan `lab_codes` mee — zie [Bloedafname bevestigen](https://docs.anivahealth.com/nl/api/appointments/confirm-blood-draw.md).

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments/c3d4e5f6-a7b8-9012-cdef-123456789012/confirm \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lab_code": "7642001234"
  }'
```

**Voorbeeldantwoord (200 OK)**

```json theme={null}
{
  "success": true
}
```

Na bevestiging wordt de laborderpipeline gestart. Je kunt de afspraak ophalen om te controleren of de status is gewijzigd in `"blood_drawn"`.

## Volgende stappen

* [Voeg panels toe aan een afspraak](https://docs.anivahealth.com/nl/api/appointments/add-panels.md) om aan te geven welke labtests moeten worden uitgevoerd.
* [Werk een afspraak bij](https://docs.anivahealth.com/nl/api/appointments/update-appointment.md) om deze te verzetten of de locatie te wijzigen voor de bloedafname.
* [Annuleer een afspraak](https://docs.anivahealth.com/nl/api/appointments/cancel-appointment.md) als deze niet meer nodig is.
* [Haal labresultaten op](https://docs.anivahealth.com/nl/api/appointments/get-results.md) om na verwerking klinische en genetische resultaten op te vragen.
* [Download documenten](https://docs.anivahealth.com/nl/api/documents/download-document.md) om pdf's van labrapporten op te halen.
* [Haal een profiel op](https://docs.anivahealth.com/nl/api/profiles/get-profile.md) om patiëntgegevens te controleren of weer te geven.
* Bekijk de volledige [API-referentie](https://docs.anivahealth.com/nl/api/profiles/create-profile.md) voor alle beschikbare endpoints en parameters.


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