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

# Document uploaden

> Upload een labrapport of een ander document naar een profiel en extraheer optioneel de labwaarden

Upload één bestand naar een profiel. Stuur het als `multipart/form-data`. Zonder `extract_results` slaat Aniva
het bestand alleen op. Met `extract_results: true` leest Aniva ook de labwaarden uit het bestand.

Je geeft niet aan wat voor soort rapport het bestand is. Aniva bepaalt dat. Een bestand zonder labresultaten, zoals
een artsenbrief, krijgt de status `stored` en is geen fout.

Lees de waarden met [Documentresultaten ophalen](https://docs.anivahealth.com/nl/api/documents/get-document-results.md). Je hoeft niet te
pollen: abonneer je op de `document.results.*`-[webhooks](https://docs.anivahealth.com/nl/concepts/webhooks.md).

Vereist de `documents_upload`-scope voor een profielgroep van het profiel. `extract_results: true`
vereist daarnaast de `documents_extract_results`-scope voor dezelfde groep. Vraag Aniva om deze toe te voegen. Het
document hoort bij die groep: sleutels met `results_view` daarop kunnen het document en de resultaten lezen.

Stuur optioneel een `Idempotency-Key`-header mee om de upload veilig opnieuw te kunnen proberen. Zie
[Idempotentie](https://docs.anivahealth.com/nl/concepts/idempotency.md).

## Wat uitlezen doet

Met `extract_results: true`:

1. Aniva stuurt het bestand naar zijn OCR- en AI-subverwerkers om de waarden uit te lezen.
2. De waarden verschijnen in de Aniva-app van het lid, net als elk ander resultaat.
3. Elke waarde heeft `origin: partner_upload` en dezelfde `status` als elk ander resultaat. Een waarde
   waarover de automatische controle van Aniva twijfelt, heeft de status `likely_wrong`.

Zonder deze optie gaat het bestand niet naar een externe dienst als je ook `document_date` meestuurt.

> [accordion] Nauwkeurigheid en gegevensbescherming
>
> * Automatisch uitlezen kan een waarde, een eenheid of een datum verkeerd lezen. Het originele
>   bestand blijft leidend. Controleer een waarde aan de hand daarvan voordat je die gebruikt voor
>   een medische beslissing. Uitgelezen waarden zijn geen diagnose.
> * De subverwerkers zijn Mistral AI (OCR, EU) en Google Cloud Vertex AI, bereikt via de Vercel AI
>   Gateway (extractie, kan buiten de EU verwerken). Ze verwerken het bestand alleen om het uit te
>   lezen.
> * Je hebt een wettelijke grondslag nodig om gezondheidsgegevens van een lid te uploaden, meestal
>   de uitdrukkelijke toestemming van het lid. Jij bent hiervoor verantwoordelijk.

## Verzoek

### Formuliervelden

**file** `file` *required*

Het bestand. PDF, DOC, DOCX, PNG of JPEG, maximaal 4 MB.

**profile\_id** `string` *required*

UUID van het profiel waar het document bij hoort.

**extract\_results** `boolean` (default: false)

`true` om de labwaarden uit het bestand uit te lezen. Stuur `true` of `false`.

**document\_date** `string`

De afnamedatum in `YYYY-MM-DD`-formaat, als je die weet. Zonder deze datum leest Aniva de datum
uit het bestand.

## Respons

De API geeft `201 Created` terug wanneer het bestand alleen is opgeslagen, en `202 Accepted` wanneer de extractie loopt.

**id** `string` *required*

Document-ID (UUID). Gebruik dit met [Documentresultaten ophalen](https://docs.anivahealth.com/nl/api/documents/get-document-results.md) en
[Document downloaden](https://docs.anivahealth.com/nl/api/documents/download-document.md).

**status** `string` *required*

`processing` terwijl Aniva de waarden uitleest, of `stored` wanneer het bestand alleen is opgeslagen.

**profile\_id** `string` *required*

Het profiel waar het document bij hoort.

**document\_date** `string`

De afnamedatum die je hebt meegestuurd, of de datum die Aniva uit een opgeslagen bestand heeft uitgelezen. Kan `null` zijn.

**results\_url** `string` *required*

De URL voor [Documentresultaten ophalen](https://docs.anivahealth.com/nl/api/documents/get-document-results.md) van dit document.

**file\_name** `string` *required*

Bestandsnaam voor weergave, dezelfde die [Document downloaden](https://docs.anivahealth.com/nl/api/documents/download-document.md) meestuurt.

**original\_file\_name** `string` *required*

De bestandsnaam die je hebt geüpload.

**origin** `string` *required*

Altijd `partner_upload`.

**content\_type** `string` *required*

Mediatype van het bestand, bijv. `application/pdf`.

**etag** `string`

Versie van de bestandsinhoud. Kan `null` zijn.

**size\_bytes** `integer`

Bestandsgrootte in bytes. Kan `null` zijn.

**lab\_code** `string`

Altijd `null` voor een geüpload document.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Een formulierveld is ongeldig, of de body is geen `multipart/form-data`. |
| `403` | Je API-sleutel mist een scope, het profiel valt buiten je toegangscontext, of je hebt `extract_results: true` gestuurd zonder `documents_extract_results`. |
| `404` | Profiel niet gevonden. |
| `409` | `duplicate_document`: hetzelfde bestand staat al bij dit profiel. `document_id` verwijst ernaar, of is `null` als je het niet kunt lezen. Wordt ook gestuurd bij een conflict met `Idempotency-Key`. |
| `413` | `file_too_large`: het bestand is groter dan 4 MB. |
| `415` | `unsupported_media_type`: het bestand is geen PDF, DOC, DOCX, PNG of JPEG. De bestandsnaam moet eindigen op `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` of `.jpeg`. |
| `500` | Interne serverfout. `extraction_not_started`: het bestand is opgeslagen als `document_id`, maar de extractie kon niet starten. Neem contact op met Aniva. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/documents \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Idempotency-Key: 5f0c2d9e-3b7a-4c1e-9f62-1d8a4e7b0c55' \
  --form 'file=@lab-report.pdf' \
  --form 'profile_id=b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e' \
  --form 'extract_results=true'
```

```json 202 theme={null}
{
  "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
  "status": "processing",
  "profile_id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
  "document_date": null,
  "results_url": "https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results",
  "file_name": "20261023 - lab-report.pdf",
  "original_file_name": "lab-report.pdf",
  "origin": "partner_upload",
  "content_type": "application/pdf",
  "etag": "56104b36f860cfd5b41efc716fdf7b6f",
  "size_bytes": 312480,
  "lab_code": null
}
```

```json 409 theme={null}
{
  "error": "duplicate_document",
  "message": "This file is already on this profile",
  "document_id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c"
}
```


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