> ## 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/ru/api/appointments/get-results.md).

Требуется право доступа `results_view`.

> [!NOTE]
>
> Доступ проверяется по профилю, которому принадлежит документ. Для документа, загруженного через [Загрузку документа](https://docs.anivahealth.com/ru/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.