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

# Dokument hochladen

> Einen Laborbericht oder ein anderes Dokument in ein Profil hochladen und optional die Laborwerte extrahieren

Lade eine Datei in ein Profil hoch. Sende sie als `multipart/form-data`. Ohne `extract_results`
speichert Aniva die Datei nur. Mit `extract_results: true` liest Aniva auch die Laborwerte aus der
Datei aus.

Du gibst nicht an, um welche Art von Bericht es sich handelt. Aniva entscheidet das. Eine Datei ohne
Laborergebnisse, wie z. B. ein Arztbrief, endet mit `stored` und ist kein Fehler.

Lies die Werte mit [Dokumentergebnisse abrufen](https://docs.anivahealth.com/de/api/documents/get-document-results.md) aus. Du musst
nicht pollen: Abonniere die [Webhooks](https://docs.anivahealth.com/de/concepts/webhooks.md) `document.results.*`.

Erfordert den Scope `documents_upload` für eine Profilgruppe des Profils. `extract_results: true`
erfordert zusätzlich den Scope `documents_extract_results` für dieselbe Gruppe. Bitte Aniva, diese
hinzuzufügen. Das Dokument gehört zu dieser Gruppe: Schlüssel mit `results_view` für diese Gruppe
lesen das Dokument und seine Ergebnisse.

Sende einen optionalen `Idempotency-Key`-Header, damit der Upload sicher wiederholt werden kann.
Siehe [Idempotenz](https://docs.anivahealth.com/de/concepts/idempotency.md).

## Was die Extraktion macht

Mit `extract_results: true`:

1. Aniva sendet die Datei an seine OCR- und KI-Unterauftragsverarbeiter, um die Werte auszulesen.
2. Die Werte erscheinen in der Aniva-App des Mitglieds, wie jedes andere Ergebnis.
3. Jeder Wert hat `origin: partner_upload` und denselben `status` wie jedes andere Ergebnis. Ein Wert,
   den die automatische Prüfung von Aniva anzweifelt, hat den Status `likely_wrong`.

Ohne Extraktion geht die Datei an keinen externen Dienst, wenn du auch `document_date` sendest.

> [accordion] Genauigkeit und Datenschutz
>
> * Automatisches Auslesen kann einen Wert, eine Einheit oder ein Datum falsch lesen. Die
>   Originaldatei bleibt maßgeblich. Gleiche einen Wert mit ihr ab, bevor du ihn für eine
>   medizinische Entscheidung nutzt. Extrahierte Werte sind keine Diagnose.
> * Die Unterauftragsverarbeiter sind Mistral AI (OCR, EU) und Google Cloud Vertex AI, erreichbar
>   über das Vercel AI Gateway (Extraktion, kann außerhalb der EU verarbeiten). Sie verarbeiten die
>   Datei nur, um sie auszulesen.
> * Du brauchst eine Rechtsgrundlage, um Gesundheitsdaten eines Mitglieds hochzuladen,
>   normalerweise die ausdrückliche Einwilligung des Mitglieds. Du bist dafür verantwortlich.

## Anfrage

### Formularfelder

**file** `file` *required*

Die Datei. PDF, DOC, DOCX, PNG oder JPEG, maximal 4 MB.

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

UUID des Profils, zu dem das Dokument gehört.

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

`true`, um die Laborwerte aus der Datei auszulesen. Sende `true` oder `false`.

**document\_date** `string`

Das Probendatum im Format `YYYY-MM-DD`, wenn du es kennst. Ohne diese Angabe liest Aniva das
Datum aus der Datei aus.

## Antwort

Die API gibt `201 Created` zurück, wenn sie die Datei nur gespeichert hat, und `202 Accepted`, wenn die Extraktion läuft.

**id** `string` *required*

Dokument-ID (UUID). Verwende sie mit [Dokumentergebnisse abrufen](https://docs.anivahealth.com/de/api/documents/get-document-results.md) und
[Dokument herunterladen](https://docs.anivahealth.com/de/api/documents/download-document.md).

**status** `string` *required*

`processing`, während Aniva die Werte extrahiert, oder `stored`, wenn die Datei nur gespeichert wird.

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

Das Profil, zu dem das Dokument gehört.

**document\_date** `string`

Das Probendatum, das du gesendet hast, oder das Datum, das Aniva aus einer gespeicherten Datei ausgelesen hat. Kann `null` sein.

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

Die URL von [Dokumentergebnisse abrufen](https://docs.anivahealth.com/de/api/documents/get-document-results.md) für dieses Dokument.

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

Dateiname für die Anzeige, derselbe, den [Dokument herunterladen](https://docs.anivahealth.com/de/api/documents/download-document.md) sendet.

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

Der Dateiname, den du hochgeladen hast.

**origin** `string` *required*

Immer `partner_upload`.

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

Medientyp der Datei, z. B. `application/pdf`.

**etag** `string`

Version des Dateiinhalts. Kann `null` sein.

**size\_bytes** `integer`

Dateigröße in Bytes. Kann `null` sein.

**lab\_code** `string`

Bei einem hochgeladenen Dokument immer `null`.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Ein Formularfeld ist ungültig oder der Body ist nicht `multipart/form-data`. |
| `403` | Deinem API-Key fehlt ein Scope, das Profil liegt außerhalb deines Zugriffskontexts oder du hast `extract_results: true` ohne `documents_extract_results` gesendet. |
| `404` | Profil nicht gefunden. |
| `409` | `duplicate_document`: Dieselbe Datei existiert bereits in diesem Profil. `document_id` nennt sie oder ist `null`, wenn du sie nicht lesen kannst. Wird auch bei einem `Idempotency-Key`-Konflikt gesendet. |
| `413` | `file_too_large`: Die Datei ist größer als 4 MB. |
| `415` | `unsupported_media_type`: Die Datei ist kein PDF, DOC, DOCX, PNG oder JPEG. Der Dateiname muss auf `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` oder `.jpeg` enden. |
| `500` | Interner Serverfehler. `extraction_not_started`: Die Datei ist als `document_id` gespeichert, aber die Extraktion konnte nicht gestartet werden. Kontaktiere 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.