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

> Ein Laborbericht-Dokument anhand der Datei-ID herunterladen

Lade ein Laborberichtsdokument über seine Datei-ID herunter. Gibt die rohen Datei-Bytes mit dem passenden `Content-Type`-Header zurück. Die Dokument-IDs findest du im `documents`-Array der Antwort von [Laborergebnisse abrufen](https://docs.anivahealth.com/de/api/appointments/get-results.md).

Erfordert den Scope `results_view`.

> [!NOTE]
>
> Der Zugriff wird anhand des Profils geprüft, zu dem das Dokument gehört. Ein Dokument, das du mit [Dokument hochladen](https://docs.anivahealth.com/de/api/documents/upload-document.md) hochgeladen hast, wird anhand der Profilgruppe geprüft, unter der es hochgeladen wurde.

## Anfrage

### Pfadparameter

**id** `string` *required*

Datei-ID (UUID) aus dem `documents`-Array in der Antwort der Terminergebnisse.

## Antwort

Bei Erfolg gibt die API `200 OK` mit den Datei-Bytes und vier Headern zurück. Jeder Header enthält ein Feld aus dem `documents`-Array:

| Header | Feld | Beispiel |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (in Anführungszeichen) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` ist prozentkodiertes UTF-8, weil ein Header nicht jedes Zeichen übertragen kann, das ein hochgeladener Name enthalten kann. Dekodiere ihn mit `decodeURIComponent` oder einer vergleichbaren Funktion.

`ETag` und `If-None-Match` sind die Standard-HTTP-Caching-Header (RFC 9110). Sende den gespeicherten `etag` in `If-None-Match`, um eine unveränderte Datei zu überspringen. Die API antwortet dann mit `304 Not Modified` ohne Body.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `304` | Nicht geändert – der `If-None-Match`-ETag passt noch zur Datei. Kein Body. |
| `400` | Ungültiges ID-Format – der angegebene Wert ist keine gültige UUID. |
| `403` | Zugriff verweigert – dein API-Schlüssel hat keinen Zugriff auf diesen Vorgang oder das Dokument liegt außerhalb deines Zugriffskontexts. |
| `404` | Dokument nicht gefunden. |
| `500` | Interner Serverfehler. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c \
  --header 'x-api-key: YOUR_API_KEY' \
  --output lab-report.pdf
```

```text 200 theme={null}
(Binary file content — save the response to a file)
```

```json 404 theme={null}
{
  "error": "Document not found"
}
```


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