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

# Upload dokument

> Upload en laboratorierapport eller et andet dokument til en profil, og udtræk eventuelt dets laboratorieværdier

Upload én fil til en profil. Send den som `multipart/form-data`. Uden `extract_results` gemmer Aniva kun
filen. Med `extract_results: true` aflæser Aniva også laboratorieværdierne fra filen.

Du angiver ikke, hvilken type rapport filen er. Aniva afgør det. En fil uden laboratorieresultater, såsom
et lægebrev, ender som `stored` og er ikke en fejl.

Læs værdierne med [Hent dokumentresultater](https://docs.anivahealth.com/da/api/documents/get-document-results.md). Du behøver ikke at
polle: Abonner på [webhooks](https://docs.anivahealth.com/da/concepts/webhooks.md) for `document.results.*`.

Kræver scopet `documents_upload` på en profilgruppe for profilen. `extract_results: true`
kræver også scopet `documents_extract_results` på den samme gruppe. Bed Aniva om at tilføje dem.
Dokumentet tilhører den gruppe: Nøgler med `results_view` på den læser dokumentet og dets resultater.

Send en valgfri `Idempotency-Key`-header for at gøre uploaden sikker at forsøge igen. Se
[Idempotens](https://docs.anivahealth.com/da/concepts/idempotency.md).

## Hvad udtrækningen gør

Med `extract_results: true`:

1. Aniva sender filen til sine OCR- og AI-underdatabehandlere for at aflæse værdierne.
2. Værdierne vises i medlemmets Aniva-app ligesom alle andre resultater.
3. Hver værdi har `origin: partner_upload` og samme `status` som alle andre resultater. En værdi,
   som Anivas automatiske tjek tvivler på, har status `likely_wrong`.

Uden den sendes filen ikke til nogen ekstern tjeneste, hvis du også sender `document_date`.

> [accordion] Nøjagtighed og databeskyttelse
>
> * Automatisk aflæsning kan fejlaflæse en værdi, en enhed eller en dato. Den oprindelige fil
>   forbliver den gældende kilde. Tjek en værdi op mod den, før du bruger den til en medicinsk
>   beslutning. Udtrukne værdier er ikke en diagnose.
> * Underdatabehandlerne er Mistral AI (OCR, EU) og Google Cloud Vertex AI, der tilgås via
>   Vercel AI Gateway (udtrækning, kan behandle uden for EU). De behandler kun filen for at aflæse
>   den.
> * Du skal have et retsgrundlag for at uploade et medlems helbredsdata, normalt medlemmets
>   udtrykkelige samtykke. Du er ansvarlig for det.

## Forespørgsel

### Formularfelter

**file** `file` *required*

Filen. PDF, DOC, DOCX, PNG eller JPEG, højst 4 MB.

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

UUID for den profil, dokumentet tilhører.

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

`true` for at aflæse laboratorieværdierne fra filen. Send `true` eller `false`.

**document\_date** `string`

Prøvedatoen i formatet `YYYY-MM-DD`, hvis du kender den. Uden den aflæser Aniva datoen fra
filen.

## Svar

API'et returnerer `201 Created`, når det kun gemte filen, og `202 Accepted`, når udtrækning kører.

**id** `string` *required*

Dokument-ID (UUID). Brug det sammen med [Hent dokumentresultater](https://docs.anivahealth.com/da/api/documents/get-document-results.md) og
[Download dokument](https://docs.anivahealth.com/da/api/documents/download-document.md).

**status** `string` *required*

`processing` mens Aniva udtrækker værdierne, eller `stored` når filen kun er gemt.

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

Den profil, dokumentet tilhører.

**document\_date** `string`

Den prøvedato, du sendte, eller den, Aniva aflæste fra en gemt fil. Kan være `null`.

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

URL'en til [Hent dokumentresultater](https://docs.anivahealth.com/da/api/documents/get-document-results.md) for dette dokument.

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

Filnavn til visning, det samme som [Download dokument](https://docs.anivahealth.com/da/api/documents/download-document.md) sender.

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

Det filnavn, du uploadede.

**origin** `string` *required*

Altid `partner_upload`.

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

Filens medietype, f.eks. `application/pdf`.

**etag** `string`

Version af filens indhold. Kan være `null`.

**size\_bytes** `integer`

Filstørrelse i bytes. Kan være `null`.

**lab\_code** `string`

Altid `null` for et uploadet dokument.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Et formularfelt er ugyldigt, eller body er ikke `multipart/form-data`. |
| `403` | Din API-nøgle mangler et scope, profilen ligger uden for din adgangskontekst, eller du sendte `extract_results: true` uden `documents_extract_results`. |
| `404` | Profil ikke fundet. |
| `409` | `duplicate_document`: den samme fil findes allerede på denne profil. `document_id` angiver den, eller er `null`, hvis du ikke kan læse den. Sendes også ved en konflikt på `Idempotency-Key`. |
| `413` | `file_too_large`: filen er over 4 MB. |
| `415` | `unsupported_media_type`: filen er ikke en PDF, DOC, DOCX, PNG eller JPEG. Filnavnet skal slutte på `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` eller `.jpeg`. |
| `500` | Intern serverfejl. `extraction_not_started`: filen er gemt som `document_id`, men udtrækning kunne ikke starte. Kontakt 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.