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

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

> Завантажити лабораторний звіт або будь-який інший документ до профілю та за бажанням витягнути з нього лабораторні показники

Завантаж один файл до профілю. Надішли його як `multipart/form-data`. Без `extract_results` Aniva лише
зберігає файл. З `extract_results: true` Aniva також зчитує лабораторні показники з файлу.

Ти не вказуєш, який це тип звіту. Це визначає Aniva. Файл без лабораторних результатів, наприклад
лист лікаря, отримує статус `stored`, і це не є помилкою.

Читай значення за допомогою [Отримати результати документа](https://docs.anivahealth.com/uk/api/documents/get-document-results.md). Опитувати API не потрібно:
підпишись на [вебхуки](https://docs.anivahealth.com/uk/concepts/webhooks.md) `document.results.*`.

Потрібен дозвіл `documents_upload` для групи профілів, до якої належить профіль. Для `extract_results: true`
також потрібен дозвіл `documents_extract_results` для тієї самої групи. Попроси Aniva додати їх.
Документ належить цій групі: ключі з дозволом `results_view` для неї можуть читати документ і його результати.

Надішли необов’язковий заголовок `Idempotency-Key`, щоб завантаження можна було безпечно повторити. Детальніше — у розділі
[Ідемпотентність](https://docs.anivahealth.com/uk/concepts/idempotency.md).

## Що робить витягування

З `extract_results: true`:

1. Aniva надсилає файл своїм субпроцесорам OCR та ШІ, щоб зчитати значення.
2. Значення з’являються в застосунку Aniva учасника, як і будь-який інший результат.
3. Кожне значення має `origin: partner_upload` і той самий `status`, що й будь-який інший результат. Значення,
   у якому автоматична перевірка Aniva сумнівається, має статус `likely_wrong`.

Без нього файл не передається жодному сторонньому сервісу, якщо ти також надсилаєш `document_date`.

> [accordion] Точність і захист даних
>
> * Автоматичне зчитування може помилково розпізнати значення, одиницю виміру або дату. Оригінальний файл
>   залишається джерелом істини. Звір значення з ним, перш ніж використовувати його для медичного рішення. Зчитані
>   значення не є діагнозом.
> * Субпроцесори — Mistral AI (OCR, ЄС) і Google Cloud Vertex AI, доступний через
>   Vercel AI Gateway (видобування даних, може обробляти за межами ЄС). Вони обробляють файл лише щоб зчитати
>   його.
> * Тобі потрібна правова підстава для завантаження даних про здоров’я учасника, зазвичай його явна
>   згода. Ти відповідаєш за це.

## Запит

### Поля форми

**file** `file` *required*

Файл. PDF, DOC, DOCX, PNG або JPEG, не більше 4 MB.

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

UUID профілю, до якого належить документ.

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

`true`, щоб зчитати лабораторні значення з файлу. Надсилай `true` або `false`.

**document\_date** `string`

Дата забору зразка у форматі `YYYY-MM-DD`, якщо ти її знаєш. Без неї Aniva зчитає дату з
файлу.

## Відповідь

API повертає `201 Created`, коли файл лише збережено, і `202 Accepted`, коли виконується видобування.

**id** `string` *required*

ID документа (UUID). Використовуй його з [Отримати результати документа](https://docs.anivahealth.com/uk/api/documents/get-document-results.md) та
[Завантажити документ](https://docs.anivahealth.com/uk/api/documents/download-document.md).

**status** `string` *required*

`processing`, поки Aniva видобуває значення, або `stored`, коли файл лише збережено.

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

Профіль, до якого належить документ.

**document\_date** `string`

Надіслана тобою дата забору зразка або дата, яку Aniva зчитала зі збереженого файлу. Може бути `null`.

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

URL для [Отримати результати документа](https://docs.anivahealth.com/uk/api/documents/get-document-results.md) цього документа.

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

Назва файлу для відображення — та сама, яку надсилає [Завантажити документ](https://docs.anivahealth.com/uk/api/documents/download-document.md).

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

Назва завантаженого тобою файлу.

**origin** `string` *required*

Завжди `partner_upload`.

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

Медіатип файлу, наприклад `application/pdf`.

**etag** `string`

Версія вмісту файлу. Може бути `null`.

**size\_bytes** `integer`

Розмір файлу в байтах. Може бути `null`.

**lab\_code** `string`

Завжди `null` для завантаженого документа.

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

| Статус | Опис |
| - | - |
| `400` | Поле форми недійсне або тіло запиту не у форматі `multipart/form-data`. |
| `403` | Твоєму API-ключу бракує scope, профіль поза твоїм контекстом доступу або передано `extract_results: true` без `documents_extract_results`. |
| `404` | Профіль не знайдено. |
| `409` | `duplicate_document`: цей самий файл уже є в цьому профілі. `document_id` вказує на нього або дорівнює `null`, якщо ти не маєш доступу на читання. Також повертається в разі конфлікту `Idempotency-Key`. |
| `413` | `file_too_large`: розмір файлу перевищує 4 MB. |
| `415` | `unsupported_media_type`: файл не є PDF, DOC, DOCX, PNG або JPEG. Назва файлу має закінчуватися на `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` або `.jpeg`. |
| `500` | Внутрішня помилка сервера. `extraction_not_started`: файл збережено під `document_id`, але видобування не вдалося запустити. Звернися до 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.