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

# Panels toevoegen

> Voeg bloedtestpanels toe aan een afspraak

Voeg een of meer bloedtestpanels toe aan een bestaande afspraak. Je kunt dit endpoint meerdere keren aanroepen om de panelselectie op te bouwen voordat je de bloedafname bevestigt.

Vereist de scope `appointments_schedule`.

> [!WARNING]
>
> Panels kunnen niet worden toegevoegd nadat je [Bloedafname bevestigen](https://docs.anivahealth.com/nl/api/appointments/confirm-blood-draw.md) hebt aangeroepen.
> Een poging om panels toe te voegen aan een bevestigde afspraak geeft `409 Conflict` terug.

Bij een capillaire bloedafname (`draw_method: capillary`) wordt de bloedafname verdeeld over microtainers. Panels gaan eerst, in
volgorde van boeking. Individuele biomarkers vullen daarna de vrije ruimte in de microtainers van de panels. Als ze
meer ruimte nodig hebben, openen ze nieuwe microtainers. We verdelen ze gelijkmatig. Elke microtainer bevat maximaal
150 µl aan individuele biomarkers. Als de resulterende set panels deze regel overtreedt, geeft de aanroep `400` terug met
een `error`-melding en wordt er geen panel toegevoegd.

## Verzoek

### Padparameters

**id** `string` *required*

Unieke identifier (UUID) van de afspraak waaraan panels worden toegevoegd.

### Bodyparameters

**panel\_ids** `string[]` *required*

Array van panel-UUID's om aan de afspraak toe te voegen. Moet ten minste één item bevatten.

## Respons

Bij succes geeft de API `200 OK` terug als bevestiging dat de panels zijn toegevoegd.

**success** `boolean`

`true` wanneer de panels met succes aan de afspraak zijn toegevoegd.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Validatiefout — bijvoorbeeld als `panel_ids` leeg is of een ongeldige UUID bevat — of bij een capillaire bloedafname passen de individuele biomarkers niet meer in hun microtainers. |
| `403` | Forbidden — je API-sleutel heeft geen toegang tot deze bewerking. |
| `404` | Afspraak of een of meer panels niet gevonden. |
| `409` | Conflict — panels kunnen niet worden toegevoegd nadat de bloedafname is bevestigd, of een panel is een thuistestkit (`error_name: "home_kit_appointment_mismatch_error"`). Bestel een thuistestkit als [thuistestkitbestelling](https://docs.anivahealth.com/nl/api/home-kit-orders/create-home-kit.md). |
| `500` | Interne serverfout. |

### Thuistestkitpanel

Een thuistestkit wordt naar de patiënt verzonden en wordt niet tijdens een afspraak afgenomen. Als een panel in `panel_ids`
een thuistestkit is, geeft de aanroep `409` terug en wordt er geen panel toegevoegd. De body bevat deze velden:

**error** `string`

Voor mensen leesbare reden.

**error\_name** `string`

Altijd `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

De afspraak waaraan het panel niet is toegevoegd.

**panel\_id** `string`

Het thuistestkitpanel.

**home\_kit\_provider** `string | null`

De aanbieder van de thuistestkit voor het panel, of `null` als deze niet bekend is.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9",
      "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
    ]
  }'
```

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

```json 400 (capillary, does not fit) theme={null}
{
  "error": "Some individual biomarkers need more than 150 µl of one lab's microtainer. Remove some of them."
}
```

```json 409 theme={null}
{
  "error": "Panels cannot be added after blood draw has been confirmed"
}
```

```json 409 (home kit panel) theme={null}
{
  "error": "Panel e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0 is a home kit (biomes) and cannot attach to appointment c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a — order it via home-kit orders",
  "error_name": "home_kit_appointment_mismatch_error",
  "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "panel_id": "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0",
  "home_kit_provider": "biomes"
}
```

```json 404 theme={null}
{
  "error": "Panels not found: e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
}
```


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