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

# Ladda upp dokument

> Ladda upp en labbrapport eller ett annat dokument till en profil och extrahera labbvärdena om du vill

Ladda upp en fil till en profil. Skicka den som `multipart/form-data`. Utan `extract_results` lagrar
Aniva bara filen. Med `extract_results: true` läser Aniva också ut labbvärdena ur filen.

Du anger inte vilken typ av rapport filen är. Aniva avgör det. En fil utan labbresultat, till exempel
ett läkarbrev, slutar som `stored` och är inget fel.

Läs värdena med [Hämta dokumentresultat](https://docs.anivahealth.com/sv/api/documents/get-document-results.md). Du behöver inte
polla: prenumerera på [webhooks](https://docs.anivahealth.com/sv/concepts/webhooks.md) för `document.results.*`.

Kräver scopet `documents_upload` för en av profilens profilgrupper. `extract_results: true`
kräver dessutom scopet `documents_extract_results` för samma grupp. Be Aniva lägga till dem.
Dokumentet tillhör den gruppen: nycklar med `results_view` för gruppen kan läsa dokumentet och dess resultat.

Skicka en valfri `Idempotency-Key`-header för att göra uppladdningen säker att köra om. Se
[Idempotens](https://docs.anivahealth.com/sv/concepts/idempotency.md).

## Vad extraheringen gör

Med `extract_results: true`:

1. Aniva skickar filen till sina underbiträden för OCR och AI för att läsa av värdena.
2. Värdena visas i medlemmens Aniva-app, precis som alla andra resultat.
3. Varje värde har `origin: partner_upload` och samma `status` som alla andra resultat. Ett värde
   som Anivas automatiska kontroll ifrågasätter får status `likely_wrong`.

Utan den skickas filen inte till någon extern tjänst om du också skickar `document_date`.

> [accordion] Noggrannhet och dataskydd
>
> * Automatisk avläsning kan läsa fel på ett värde, en enhet eller ett datum. Originalfilen förblir
>   facit. Kontrollera ett värde mot den innan du använder det för ett medicinskt beslut.
>   Extraherade värden är ingen diagnos.
> * Underbiträdena är Mistral AI (OCR, EU) och Google Cloud Vertex AI, som nås via
>   Vercel AI Gateway (extrahering, kan behandla data utanför EU). De behandlar bara filen för att
>   läsa av den.
> * Du behöver en rättslig grund för att ladda upp en medlems hälsodata, normalt medlemmens
>   uttryckliga samtycke. Du ansvarar för detta.

## Förfrågan

### Formulärfält

**file** `file` *required*

Filen. PDF, DOC, DOCX, PNG eller JPEG, högst 4 MB.

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

UUID för profilen som dokumentet tillhör.

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

`true` för att läsa av labbvärdena ur filen. Skicka `true` eller `false`.

**document\_date** `string`

Provtagningsdatumet i formatet `YYYY-MM-DD`, när du känner till det. Utan det läser Aniva av
datumet från filen.

## Svar

API:et returnerar `201 Created` när filen bara har sparats, och `202 Accepted` när extrahering körs.

**id** `string` *required*

Dokument-ID (UUID). Använd det med [Hämta dokumentresultat](https://docs.anivahealth.com/sv/api/documents/get-document-results.md) och
[Ladda ner dokument](https://docs.anivahealth.com/sv/api/documents/download-document.md).

**status** `string` *required*

`processing` medan Aniva extraherar värdena, eller `stored` när filen bara har sparats.

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

Profilen som dokumentet tillhör.

**document\_date** `string`

Provtagningsdatumet du skickade, eller det som Aniva läste av från en sparad fil. Kan vara `null`.

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

URL:en till [Hämta dokumentresultat](https://docs.anivahealth.com/sv/api/documents/get-document-results.md) för det här dokumentet.

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

Filnamn för visning, samma som [Ladda ner dokument](https://docs.anivahealth.com/sv/api/documents/download-document.md) skickar.

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

Filnamnet du laddade upp.

**origin** `string` *required*

Alltid `partner_upload`.

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

Filens mediatyp, t.ex. `application/pdf`.

**etag** `string`

Version av filinnehållet. Kan vara `null`.

**size\_bytes** `integer`

Filstorlek i byte. Kan vara `null`.

**lab\_code** `string`

Alltid `null` för ett uppladdat dokument.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Ett formulärfält är ogiltigt, eller så är bodyn inte `multipart/form-data`. |
| `403` | Din API-nyckel saknar ett scope, profilen ligger utanför din åtkomstkontext, eller så skickade du `extract_results: true` utan `documents_extract_results`. |
| `404` | Profilen hittades inte. |
| `409` | `duplicate_document`: samma fil finns redan på den här profilen. `document_id` anger den, eller är `null` när du inte har läsbehörighet. Skickas även vid en `Idempotency-Key`-konflikt. |
| `413` | `file_too_large`: filen är större än 4 MB. |
| `415` | `unsupported_media_type`: filen är inte en PDF, DOC, DOCX, PNG eller JPEG. Filnamnet måste sluta på `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` eller `.jpeg`. |
| `500` | Internt serverfel. `extraction_not_started`: filen har sparats som `document_id`, men extraheringen kunde inte starta. Kontakta 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.