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

# Получить результаты из документа

> Получить статус и извлечённые лабораторные показатели загруженного тобой документа

Прочитай статус и лабораторные значения документа, загруженного через
[Загрузку документа](https://docs.anivahealth.com/ru/api/documents/upload-document.md). Ответ имеет ту же структуру, что и
[Получение результатов анализов](https://docs.anivahealth.com/ru/api/appointments/get-results.md) для записи. Все поля смотри в
[Результатах](https://docs.anivahealth.com/ru/concepts/results.md).

Ответ возвращается только для документов, загруженных в группу профилей, из которой твой ключ
может читать результаты. Для всех остальных документов возвращается `404`: их результаты читай
через запись или заказ набора для домашнего теста, по которому они получены.

Постоянно опрашивать API не нужно. Подпишись на [вебхуки](https://docs.anivahealth.com/ru/concepts/webhooks.md)
`document.results.updated` или `document.results.completed` и вызывай этот эндпоинт при
получении события.

Требуется разрешение `results_view` для группы профилей, в которую был загружен документ.

## Запрос

### Параметры пути

**id** `string` *required*

ID документа (UUID) из ответа на загрузку.

### Заголовки

**If-None-Match** `string`

Значение `ETag` из предыдущего ответа. Если ничего не изменилось, API ответит `304 Not Modified`
без тела.

## Ответ

При успехе API возвращает `200 OK` с объектом результатов и заголовком `ETag`.

**status** `string` *required*

Одно из значений:

* `in_progress` — Aniva извлекает значения.
* `completed` — извлечение завершено.
* `fault` — ошибка извлечения.
* `stored` — в документе нет значений: он загружен без `extract_results` или не содержит
  лабораторных результатов. Статус `stored` окончательный: вебхук `document.results.completed` не
  придет.

**clinical\_results** `object[]` *required*

Извлеченные значения. У каждого значения указано `origin: partner_upload`. Если в отчете
несколько дат сдачи образцов, каждое значение получает свое `tested_at`. Статуса `planned` не
бывает: загрузка ничего не заказывает.

**genetic\_results** `object[]` *required*

Генетические результаты. Для загруженного документа сейчас пусто.

**documents** `object[]` *required*

Сам загруженный документ.

**submissions** `object[]` *required*

Один элемент для этой загрузки. `lab_code` равен `null`.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `304` | Не изменено — значение etag в `If-None-Match` совпадает. Без тела. |
| `400` | Неверный формат ID. |
| `403` | У твоего API-ключа нет разрешения `results_view`. |
| `404` | Среди загруженных в твои группы профилей нет документа с таким ID. |
| `500` | Внутренняя ошибка сервера. |

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

```json 200 theme={null}
{
  "status": "stored",
  "submissions": [{ "lab_code": null, "status": "completed" }],
  "clinical_results": [],
  "genetic_results": [],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
      "file_name": "20261023 - Arztbrief.pdf",
      "original_file_name": "arztbrief.pdf",
      "origin": "partner_upload",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 182311,
      "lab_code": null
    }
  ]
}
```


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