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

# Звантажити документ

> Звантажити документ із лабораторним звітом за ID файлу

Завантаж документ лабораторного звіту за його ID файлу. Повертає необроблені байти файлу з відповідним заголовком `Content-Type`. ID документів можна отримати з масиву `documents` у відповіді [Отримати результати аналізів](https://docs.anivahealth.com/uk/api/appointments/get-results.md).

Потребує дозволу `results_view`.

> [!NOTE]
>
> Доступ перевіряється за профілем, якому належить документ. Документ, завантажений через [Завантажити документ](https://docs.anivahealth.com/uk/api/documents/upload-document.md), перевіряється за групою профілів, у яку його завантажено.

## Запит

### Параметри шляху

**id** `string` *required*

ID файлу (UUID) з масиву `documents` у відповіді з результатами запису.

## Відповідь

У разі успіху API повертає `200 OK` із байтами файлу та чотирма заголовками. Кожен заголовок містить поле масиву `documents`:

| Заголовок | Поле | Приклад |
| - | - | - |
| `Content-Type` | `content_type` | `application/pdf` |
| `Content-Disposition` | `file_name` | `attachment; filename="20260405 - Quade Befund - 7642001234.pdf"` |
| `ETag` | `etag` (у лапках) | `"56104b36f860cfd5b41efc716fdf7b6f"` |
| `Original-File-Name` | `original_file_name` | `7642001234_B0012_FA_E.pdf` |

`Original-File-Name` передається в UTF-8 із відсотковим кодуванням, оскільки заголовок не може містити всі символи, які можуть бути в назві завантаженого файлу. Декодуй його за допомогою `decodeURIComponent` або аналога.

`ETag` та `If-None-Match` — це стандартні HTTP-заголовки кешування (RFC 9110). Надішли наявний у тебе `etag` у заголовку `If-None-Match`, щоб пропустити незмінений файл. Тоді API відповість `304 Not Modified` без тіла відповіді.

## Відповіді з помилками

| Статус | Опис |
| - | - |
| `304` | Не змінено — etag із `If-None-Match` досі відповідає файлу. Без тіла відповіді. |
| `400` | Неправильний формат ID — передане значення не є коректним UUID. |
| `403` | Доступ заборонено — твій API-ключ не має доступу до цієї операції або документ поза твоїм контекстом доступу. |
| `404` | Документ не знайдено. |
| `500` | Внутрішня помилка сервера. |

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