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

# Получить лабораторные результаты

> Получить клинические и генетические лабораторные результаты по заказу набора для домашнего теста

Получи клинические и генетические лабораторные результаты для заказа набора для домашнего теста, а также ссылки на PDF-документы лабораторных отчётов.

Каждый биомаркер, заказанный для набора, отображается в ответе, поэтому ты можешь отслеживать весь заказ, а не только то, что уже пришло. Результаты поступают под `lab_code` заказа — заказ в лабораторию размещается при [активации](https://docs.anivahealth.com/ru/api/home-kit-orders/activate-home-kit.md), и лаборатория присылает маркеры по отдельности по мере анализа, так что частичные данные — это нормально, а верхнеуровневый `status` остаётся `in_progress` до финального отчёта. Проверяй `status` каждого результата, прежде чем использовать его `value`:

* Ещё не выполненные тесты отображаются со статусом `planned`, пока заказ находится в статусе `in_progress`. Ты можешь вызвать этот эндпоинт до активации — тогда каждый заказанный маркер будет в статусе `planned`.
* Результаты, которые лаборатория передала, но которые **нельзя** использовать в клинических целях, имеют статус `fault` или `undeliverable` и содержат `status_reason` с объяснением причины. У результата со статусом `fault` поле `value` всё ещё заполнено — это значение ошибочно. Никогда не показывай его как результат анализа.
* Результаты, в которых сомневаются Aniva или участник, имеют статус `likely_wrong` и `status_reason`. Значение не подтверждено. Не показывай его как результат анализа без проверки.

Используй [Скачать документ](https://docs.anivahealth.com/ru/api/documents/download-document.md), чтобы загрузить PDF-файлы лабораторных отчётов, указанные в массиве `documents`.

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

Требуется разрешение `results_view` — лабораторные результаты и документы всегда защищены им, как результаты записей и [Скачать документ](https://docs.anivahealth.com/ru/api/documents/download-document.md), — а также разрешение `home_kit_orders_view` или `home_kit_orders_manage` для доступа к самому заказу набора.

## Запрос

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

**id** `string` *required*

Уникальный идентификатор (UUID) заказа набора для домашнего теста, для которого нужно получить результаты.

## Ответ

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

**status** `string` *required*

Общий статус результатов. Одно из значений:

* `in_progress` — часть направлений ещё находится в лаборатории.
* `completed` — все направления закрыты, и хотя бы по одному пришёл отчёт.
* `fault` — все направления завершились ошибкой без отчёта. Больше ничего не ожидается.

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

По одному элементу на каждое лабораторное направление — у забора крови с несколькими пробирками или лабораториями их
несколько. Верхнеуровневый `status` становится `completed`, как только все элементы закрыты и по одному из них пришёл отчёт.

**объект submission**

**lab\_code** `string`

Лабораторный код (штрихкод пробирки), под которым зарегистрировано это направление. Может быть `null`, если лаборатория
его не указала.

**status** `string` *required*

`in_progress`, пока лаборатория ещё работает над ним, `completed`, когда отчёт
готов окончательно, или `fault`, если направление отклонили или отменили и отчёта по нему никогда не будет —
образец часто передают в другую лабораторию, которая затем создаёт собственный элемент.

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

Массив результатов клинических биомаркеров.

**объект клинического результата**

**id** `string`

Идентификатор строки лабораторного результата (UUID). Он не меняется, если лаборатория исправляет строку, поэтому используй его для обновления или вставки. `null` для результата со статусом `planned`.

**status** `string` *required*

Статус результата. Одно из значений:

* `planned` — заказан, лаборатория еще не прислала результат. `value` равно `null`.
* `received` — получен от лаборатории.
* `corrected` — получен, затем исправлен вручную. В `value` указано исправленное значение.
* `likely_wrong` — автоматическая проверка Aniva или участник сомневается в значении. Не подтверждено: не показывай его как результат без проверки. Смотри `status_reason`.
* `fault` — получен, но подтверждено, что он ошибочный; **не используй в клинической практике**. В `value` указано ошибочное значение. Смотри `status_reason`.
* `undeliverable` — лаборатория не смогла получить значение. `value` равно `null`. Смотри `status_reason`.

**status\_reason** `string` *required*

Почему результат вызывает сомнения или непригоден. Заполнено для `likely_wrong`, `fault` и `undeliverable`, `null` для всех остальных статусов.

Отличается от `comment`, в котором хранится примечание самой лаборатории из отчета — в большинстве ошибочных результатов поле `comment` пустое, поэтому считай `status_reason` основным объяснением.

**lab\_code** `string`

Лабораторный код (штрихкод пробирки), под которым зарегистрирован результат — один из лабораторных кодов заказа. `null` для результата со статусом `planned` и для результатов, которые лаборатория передала без кода.

**biomarker\_id** `integer` *required*

Идентификатор биомаркера.

**biomarker\_name** `string` *required*

Отображаемое название биомаркера.

**category** `string`

Категория биомаркера (например, гормоны, витамины). Может быть `null`.

**value** `number`

Итоговое значение результата (исправленное, если оно есть, иначе исходное). Может быть `null`.

**value\_operator** `string`

Оператор сравнения для значения: `eq` (равно), `lt` (меньше) или `gt` (больше). Может быть `null`.

**unit\_id** `integer`

Идентификатор единицы измерения. Может быть `null`.

**unit** `string`

Отображаемое название единицы измерения. Может быть `null`.

**reference\_range\_lab** `object`

Референсные интервалы, переданные лабораторией для **этого** результата, переведенные в ту же единицу измерения, что и `value`. `null`, если лаборатория не передала интервал.

Граница, которую лаборатория оставила открытой, остается `null`, поэтому в одностороннем интервале заполнена только одна сторона — верхний порог приходит как `normal_min: null, normal_max: 50`, а нижний как `normal_min: 55, normal_max: null`. Не воспринимай границу со значением `null` как ноль или отсутствие ограничений по умолчанию; читай ее как «лаборатория не задала ограничение с этой стороны».

Каждый результат содержит интервал, с которым его сравнивали при измерении, поэтому пациент, чьи результаты охватывают несколько заборов крови или несколько лабораторий, получает правильный интервал для каждого результата, а не только последний.

**референсный интервал**

**normal\_min** `number`

Нижняя граница нормального интервала. Может быть `null`.

**normal\_max** `number`

Верхняя граница нормального интервала. Может быть `null`.

**optimal\_min** `number`

Нижняя граница оптимального интервала. Может быть `null`.

**optimal\_max** `number`

Верхняя граница оптимального интервала. Может быть `null`.

**reference\_range\_lab\_absent\_reason** `string`

Почему `reference_range_lab` равно `null`. `null`, если `reference_range_lab` присутствует, а также для результата со статусом `planned`.

* `not_provided`: интервала нет. Лаборатория его не передала. Показывай «Не применимо».
* `lab_text_only`: лаборатория указала только текст, например целевое значение, уровень риска или интервал для определенного этапа жизни. Показывай `lab_reported.reference_range`.
* `not_measured`: результат имеет статус `undeliverable`, поэтому нет значения для сравнения. Показывай `status_reason`.

**aniva\_range** `object`

Сравнительные значения, собранные Aniva, в той же шкале, что и `value`. Они различаются в зависимости от возраста, пола и недели беременности. `normal_*` — общий интервал. `optimal_*` — более узкий интервал. Эти значения даны только для информации. Они не являются медицинской рекомендацией, диагнозом или оценкой результата. Aniva не выставляет по ним флаги. Используй `reference_range_lab` как стандарт для результата. `null`, если у твоего ключа нет области доступа `aniva_ranges_view` или у Aniva нет значений для этого биомаркера.

**референсный интервал**

**normal\_min** `number`

Нижняя граница нормального интервала. Может быть `null`.

**normal\_max** `number`

Верхняя граница нормального интервала. Может быть `null`.

**optimal\_min** `number`

Нижняя граница оптимального интервала. Может быть `null`.

**optimal\_max** `number`

Верхняя граница более узкого интервала. Может быть `null`.

**sources** `object[]`

Опубликованные источники, которые Aniva сохранила для этих значений. Каждая запись содержит `title` и `url`. Поле `url` может быть `null`. Список пустой, если Aniva не сохранила ни одного источника.

**tested\_at** `string`

Дата проведения анализа в формате `YYYY-MM-DD`. Может быть `null`.

**comment** `string`

Необязательный комментарий к результату. Может быть `null`.

**origin** `string`

Кто передал документ, из которого взято это значение, — аналогично полю `origin` документа. Значение из загруженного документа получено из файла, который прочитала Aniva, а не из лабораторного отчета. `null` для результата со статусом `planned`.

**lab\_reported** `object`

Дословная строка из отчета выполнявшей анализ лаборатории — для сверки этих данных с PDF-файлом лаборатории. Может быть `null`, если у нас нет исходной записи для этого результата.

Все остальные поля результата нормализованы: `value` и `unit` переведены в единицу измерения биомаркера по умолчанию, а `biomarker_name` — это наше название аналита, а не лабораторное. Поля ниже не нормализованы. Рассматривай их как исходные данные из отчета, а канонические поля — как перекрестную проверку согласованности.

Числа здесь — это собственные границы лаборатории в ее собственной шкале: `reference_range_min` и `reference_range_max` **не** переведены в другие единицы измерения и будут отличаться от `reference_range_lab` везде, где две шкалы не совпадают. Граница, которую лаборатория оставила открытой, остается `null`; ничего не додумывается и не подставляется по умолчанию.

**данные лаборатории**

**name** `string`

Название аналита в том виде, как его указала лаборатория. Может быть `null`.

**code** `string`

Собственный код аналита лаборатории. Может быть `null`.

**category** `string`

Заголовок раздела отчета, например `Klinische Chemie`. Может быть `null`.

**value** `string`

Значение в том виде, как оно указано в отчете. Передается строкой, чтобы нечисловые результаты сохранялись без изменений (`<0.04`, `negativ`, `1:100`). Может быть `null`.

**unit** `string`

Единица измерения в том виде, как она указана в отчете, например `U/l`. Может быть `null`.

**reference\_range** `string`

Референсный интервал в том виде, как он указан в отчете, включая односторонние пороги: `40 - 129`, `< 50`, `> 55`. Может быть `null`.

**reference\_range\_min** `number`

Нижняя граница лаборатории без пересчета единиц. `null`, если лаборатория оставила интервал открытым снизу.

**reference\_range\_max** `number`

Верхняя граница лаборатории без пересчета единиц. `null`, если лаборатория оставила интервал открытым сверху.

**flag** `string`

Флаг отклонения от лаборатории для этой строки: `normal`, `high`, `low`, `critical_high`, `critical_low`, `abnormal`. Нераспознанный код передается в том виде, в каком его прислала лаборатория. Может быть `null`.

**result\_status** `string`

Статус результата от лаборатории: `final`, `preliminary`, `correction`, `incomplete`, `partial`, `deleted`, `cannot_be_obtained`. Значение со статусом `preliminary` еще может измениться. Последующий [вебхук](https://docs.anivahealth.com/ru/concepts/webhooks.md)`results.updated` подскажет, когда запросить данные снова. Может быть `null`.

**comment** `string`

Примечание самой лаборатории к этой строке. Лишние пробелы для выравнивания колонок сжаты; формулировка не изменена. Может быть `null`.

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

Массив результатов генетических биомаркеров.

**объект генетического результата**

**id** `string`

Идентификатор строки лабораторного результата (UUID). Он не меняется, если лаборатория исправляет строку, поэтому используй его для обновления или вставки. `null` для результата со статусом `planned`.

**status** `string` *required*

Статус результата. Одно из значений:

* `planned` — заказан, лаборатория еще не прислала результат.
* `received` — получен от лаборатории.
* `likely_wrong` — автоматическая проверка Aniva или участник сомневается в генотипе. Не подтверждено. Смотри `status_reason`.
* `fault` — получен, но подтверждено, что он ошибочный; **не используй в клинической практике**. Смотри `status_reason`.
* `undeliverable` — лаборатория не смогла определить генотип. Смотри `status_reason`.

**status\_reason** `string` *required*

Почему результат вызывает сомнения или непригоден. Заполнено для `likely_wrong`, `fault` и `undeliverable`, `null` для всех остальных статусов.

**lab\_code** `string`

Лабораторный код (штрихкод пробирки), под которым зарегистрирован результат. `null` для результата со статусом `planned` и для результатов, которые лаборатория передала без кода.

**biomarker\_id** `integer` *required*

Идентификатор биомаркера (гена).

**gene** `string` *required*

Обозначение гена (например, APOE, MTHFR).

**genotype** `string`

Отображение генотипа (например, E3/E4). Может быть `null`.

**clinical\_significance** `string`

Общая клиническая значимость. Одно из значений: `pathogenic`, `likely_pathogenic`, `uncertain`, `likely_benign`, `benign`, `high_risk`, `moderate_risk`, `low_risk`, `protective`, `drug_response`, `poor_metabolizer` или `rapid_metabolizer`. Может быть `null`.

**risk\_description** `string`

Описание риска для этого генотипа. Может быть `null`.

**tested\_at** `string`

Дата проведения анализа в формате `YYYY-MM-DD`. Может быть `null`.

**comment** `string`

Необязательный комментарий к результату. Может быть `null`.

**origin** `string`

Кто передал документ, из которого взято это значение, — аналогично полю `origin` документа. Значение из загруженного документа получено из файла, который прочитала Aniva, а не из лабораторного отчета. `null` для результата со статусом `planned`.

**variants** `object[]` *required*

Обнаруженные генетические варианты.

**объект варианта**

**name** `string` *required*

Общепринятое название варианта (например, APOE E4).

**clinical\_significance** `string`

Клиническая значимость на уровне варианта. Может быть `null`.

**description** `string`

Описание варианта. Может быть `null`.

**hgvs\_c** `string`

Нотация HGVS для кодирующей ДНК. Может быть `null`.

**hgvs\_p** `string`

Нотация HGVS для белка. Может быть `null`.

**conditions** `object[]` *required*

Связанные состояния.

**объект состояния**

**condition** `string` *required*

Название состояния или заболевания.

**association\_description** `string`

Описание связи между вариантом и состоянием. Может быть `null`.

**badge** `string`

Короткий текст бейджа для отображения. Может быть `null`.

**snvs** `object[]` *required*

Однонуклеотидные варианты, определяющие этот вариант.

**объект SNV**

**rs\_id** `string` *required*

Идентификатор dbSNP (например, rs429358).

**allele** `string` *required*

Аллель варианта (`A`, `C`, `G`, `T`, `del`, `ins` или `undetermined`).

**reference\_allele** `string` *required*

Референсный аллель в популяции.

**hgvs\_c** `string`

Нотация HGVS для кодирующей ДНК. Может быть `null`.

**hgvs\_p** `string`

Нотация HGVS для белка. Может быть `null`.

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

Документы лабораторных отчётов. Используй `GET /api/v1/documents/{id}`, чтобы скачать каждый файл.

**объект документа**

**id** `string` *required*

Идентификатор файла (UUID). Передай его в [Скачать документ](https://docs.anivahealth.com/ru/api/documents/download-document.md), чтобы получить файл.

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

Имя файла. [Скачать документ](https://docs.anivahealth.com/ru/api/documents/download-document.md) отправляет то же имя в `Content-Disposition`. Оно содержит дату, название документа и лабораторный код, например `20260405 - Quade Befund - 7642001234.pdf`. Используй его только для отображения. Бери лабораторный код из `lab_code`, а не из имени файла.

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

Имя файла точно в том виде, в котором его передал источник, например `7642100312_B0012_FA_V.pdf` от лаборатории или имя файла, загруженного участником. Aniva его не меняет.

**origin** `string` *required*

Кто передал файл. Одно из значений: `lab` (прислала лаборатория), `member_upload` (загрузил участник), `staff_upload` (загрузили сотрудники Aniva) или `partner_upload` (загружено тобой через [Загрузить документ](https://docs.anivahealth.com/ru/api/documents/upload-document.md)).

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

Медиатип файла, например `application/pdf`, `image/jpeg` или `text/csv`. Большинство лабораторных отчётов — это PDF.

**etag** `string`

Версия содержимого файла. Она меняется при любом изменении байтов, поэтому сравнивай её с сохранённым значением, чтобы понять, нужно ли скачивать файл снова. [Скачать документ](https://docs.anivahealth.com/ru/api/documents/download-document.md) отправляет её в кавычках как стандартный HTTP-заголовок `ETag`. Может быть `null`, если сохранённый файл отсутствует.

**size\_bytes** `integer`

Размер файла в байтах. Может быть `null`, если сохранённый файл отсутствует.

**lab\_code** `string`

Лабораторный код (штрихкод пробирки), к которому относится отчёт. Может быть `null`, если лаборатория его не указала.

## Повторные вызовы

Aniva хранит ответ этого эндпоинта 60 минут для каждого API-ключа. Повторный запрос в течение
этого времени получает сохранённый ответ, пока заказ набора для домашнего теста и его результаты не изменились. После изменения ты получишь свежий
ответ. Заголовки `Cache-Status` и `Age` показывают, что ответ
сохранён и как давно.

Чтобы узнавать об изменениях сразу, подпишись на события вебхуков `home_kit_order.results.updated`, `home_kit_order.results.completed` и `home_kit_order.results.fault`.
См. [Повторные запросы](https://docs.anivahealth.com/ru/concepts/webhooks.md#povtornye-chteniya).

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

| Статус | Описание |
| - | - |
| `400` | Неверный формат ID — переданное значение не является корректным UUID. |
| `403` | Доступ запрещён — у твоего API-ключа отсутствует разрешение `results_view`, отсутствуют оба разрешения `home_kit_orders_view` и `home_kit_orders_manage`, или заказ набора для домашнего теста находится вне твоего контекста доступа. |
| `404` | Заказ набора для домашнего теста не найден. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "status": "in_progress",
  "submissions": [
    {
      "lab_code": "7642001234",
      "status": "in_progress"
    }
  ],
  "clinical_results": [
    {
      "id": "e9f1a3c5-6b7d-4c2e-8a4f-1d3b5c7e9f02",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 104,
      "biomarker_name": "Vitamin D",
      "category": "Vitamins",
      "value": 38.5,
      "value_operator": "eq",
      "unit_id": 1,
      "unit": "ng/mL",
      "reference_range_lab": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": 30,
        "optimal_max": 60,
        "sources": [
          {
            "title": "Example source title",
            "url": "https://example.com/source"
          }
        ]
      },
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "Vitamin D (25-OH)",
        "code": "vitd",
        "category": "Endokrinologie",
        "value": "38.5",
        "unit": "ng/ml",
        "reference_range": "30 - 100",
        "reference_range_min": 30,
        "reference_range_max": 100,
        "flag": "normal",
        "result_status": "final",
        "comment": null
      }
    },
    {
      "id": null,
      "status": "planned",
      "status_reason": null,
      "lab_code": null,
      "biomarker_id": 79,
      "biomarker_name": "Thyroid-Stimulating Hormone (TSH)",
      "category": "Hormones",
      "value": null,
      "value_operator": null,
      "unit_id": null,
      "unit": null,
      "reference_range_lab": null,
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": null,
      "comment": null,
      "origin": null,
      "lab_reported": null
    }
  ],
  "genetic_results": [
    {
      "id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8b0d13",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 348,
      "gene": "APOE",
      "genotype": "E3/E4",
      "clinical_significance": "moderate_risk",
      "risk_description": "Carriers of one APOE E4 allele have a moderately increased risk of Alzheimer's disease.",
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "variants": [
        {
          "name": "APOE E4",
          "clinical_significance": "moderate_risk",
          "description": "The E4 allele is associated with increased Alzheimer's risk.",
          "hgvs_c": "c.388T>C",
          "hgvs_p": "p.Cys130Arg",
          "conditions": [
            {
              "condition": "Alzheimer's disease",
              "association_description": "Increased risk with one E4 allele",
              "badge": "Moderate Risk"
            }
          ],
          "snvs": [
            {
              "rs_id": "rs429358",
              "allele": "C",
              "reference_allele": "T",
              "hgvs_c": "c.388T>C",
              "hgvs_p": "p.Cys130Arg"
            }
          ]
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c",
      "file_name": "20260405 - Quade Befund - 7642001234.pdf",
      "original_file_name": "7642001234_B0012_FA_E.pdf",
      "origin": "lab",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 258341,
      "lab_code": "7642001234"
    }
  ]
}
```

```json 404 theme={null}
{
  "error": "Home kit order not found"
}
```


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