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

Получи одну запись на забор крови по её UUID вместе со встроенным профилем пациента. Используй этот эндпоинт, чтобы проверить статус записи, уточнить детали расписания или получить связанные данные профиля.

Требуется право доступа `appointments_view` или `appointments_schedule`.

## Запрос

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

**id** `string` *required*

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

## Ответ

При успехе API возвращает `200 OK` с записью и встроенным профилем.

**id** `string` *required*

Уникальный идентификатор записи (UUID).

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

UUID профиля, к которому относится эта запись.

**location\_id** `string`

UUID локации для сдачи анализов, где проходит забор крови.

**scheduled\_at** `string`

Запланированные дата и время записи в UTC (ISO 8601 с суффиксом `Z`, например,
`2026-05-15T10:30:00Z`). Может быть `null`.

**status** `string` *required*

Текущий статус записи. Одно из значений: `pending`, `confirmed`, `blood_drawn` или `cancelled`.
Детали готовности лабораторных результатов можно получить в [Получить результаты](https://docs.anivahealth.com/ru/api/appointments/get-results.md),
а подробный ход доставки — из каждого элемента встроенного массива `shipments` (см. ниже)
с переходом в [Получить отправку](https://docs.anivahealth.com/ru/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Причина в свободной форме, указанная при отмене записи (например, неявка, поздняя отмена,
«Не удалось. Требуется повтор»). Имеет значение `null`, если `status` не равен `cancelled`.

**results\_ready\_emails** `string[]` *required*

Адреса в нижнем регистре, на каждый из которых приходит одно письмо, когда все результаты
лаборатории готовы. Пустой список, если отключено. См.
[Письма о готовности результатов](https://docs.anivahealth.com/ru/concepts/results.md#pisma-o-gotovnosti-rezultatov).

**draw\_method** `string` *required*

Способ забора крови: `capillary` (из пальца или плеча в микротейнеры) или `venous` (из вены
в пробирки). Используется способ, заданный для записи, иначе `default_draw_method` её
[локации](https://docs.anivahealth.com/ru/concepts/locations.md). После забора крови здесь указан фактически использованный способ.

**created\_at** `string` *required*

Временная метка создания записи в формате ISO 8601.

**updated\_at** `string`

Временная метка последнего обновления в формате ISO 8601. Может быть `null`.

**profile** `object` *required*

Профиль пациента, связанный с этой записью.

**профиль**

**id** `string`

Уникальный идентификатор профиля (UUID).

**handle** `string`

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

**first\_name** `string`

Имя. Может быть `null`.

**last\_name** `string`

Фамилия. Может быть `null`.

**email** `string`

Адрес электронной почты. Может быть `null`.

**phone** `string`

Номер телефона в формате E.164. Может быть `null`.

**sex** `integer`

Биологический пол по стандарту ISO/IEC 5218. Может быть `null`.

**date\_of\_birth** `string`

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

**height** `number`

Рост в сантиметрах. Может быть `null`.

**weight** `number`

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

**language** `string`

Предпочитаемый язык: один из 32 кодов из [Создать профиль](https://docs.anivahealth.com/ru/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Получает ли профиль транзакционные (автоматические) письма. Может быть `null`.

**created\_at** `string`

Временная метка создания профиля в формате ISO 8601.

**updated\_at** `string`

Временная метка последнего обновления профиля в формате ISO 8601. Может быть `null`.

**panels** `AppointmentPanel[]` *required*

Панели, прикреплённые к этой записи на данный момент. Отменённые прикрепления не включаются. Подробности о панели
(название, биомаркеры) можно посмотреть через [Список панелей](https://docs.anivahealth.com/ru/api/panels/list-panels.md).

**Поля прикреплённой панели**

**panel\_id** `string`

UUID панели — сверь со [Списком панелей](https://docs.anivahealth.com/ru/api/panels/list-panels.md).

**added\_at** `string`

Временная метка ISO 8601, когда панель была впервые прикреплена к этой записи.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

Отдельные биомаркеры, прикреплённые к этой записи вне какой-либо панели (см. [Добавить
отдельные биомаркеры](https://docs.anivahealth.com/ru/api/appointments/add-individual-biomarkers.md)). Сверь каждый `biomarker_id`
со [Списком биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md), чтобы получить данные для отображения.

**Поля отдельного биомаркера**

**biomarker\_id** `integer`

Идентификатор биомаркера — сверь со
[Списком биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

Временная метка ISO 8601, когда биомаркер был впервые прикреплён к этой записи.

**shipments** `AppointmentShipmentLink[]` *required*

Отправления, связанные с этой записью, начиная с самой ранней привязки. Пустой массив, если отправления
не связаны. Сопоставь каждый `id` с [Получить отправление](https://docs.anivahealth.com/ru/api/shipments/get-shipment.md), чтобы получить
полные данные об отправлении (статус, трек-номер, обновления статуса и т. д.).

**Поля привязанной отправки**

**id** `string`

Идентификатор отправки — сверь через
[Получить отправку](https://docs.anivahealth.com/ru/api/shipments/get-shipment.md).

**added\_at** `string`

Временная метка ISO 8601, когда отправка была впервые привязана к этой записи.

**lab\_codes** `string[]` *required*

Лабораторные коды (штрихкоды пробирок), записанные для этой записи, в порядке сканирования. Список
пуст, пока забор крови не подтверждён. При венозном заборе один код напечатан на каждой пробирке;
при капиллярном — свой код на каждом микротейнере. Результаты и документы в
[Получить результаты](https://docs.anivahealth.com/ru/api/appointments/get-results.md) ссылаются на эти коды через `lab_code`.

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

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

Чтобы узнавать об изменениях сразу, подпишись на события вебхуков `appointment.created`, `appointment.rescheduled` и событие каждого статуса, например `appointment.confirmed`.
См. [Повторные чтения](https://docs.anivahealth.com/ru/concepts/webhooks.md#povtornye-chteniya).

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

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

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [
    {
      "biomarker_id": 42,
      "added_at": "2026-04-01T09:52:00Z"
    }
  ],
  "shipments": [
    {
      "id": "P2611194821",
      "added_at": "2026-04-15T07:00:00Z"
    }
  ],
  "lab_codes": []
}
```

```json 400 theme={null}
{
  "error": "Invalid appointment ID format"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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