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

# Получить список панелей

> Просмотреть каталог панелей

Возвращает панели, которые твой API-ключ может добавить через [Добавить панели](https://docs.anivahealth.com/ru/api/appointments/add-panels.md). Требуется
область доступа `panels_access`. Для объекта `pricing` также требуется область доступа `prices_view`.

> [!NOTE]
>
> Посчитай `biomarker_groups`, чтобы узнать, сколько результатов вернёт забор крови. В группе
> перечислены взаимозаменяемые биомаркеры (hs-CRP *или* CRP), и лаборатория измеряет только один из
> них.

## Запрос

### Параметры запроса

**rate\_card** `string`

Тарифная карта для `price_cents`: `retail` или `id` тарифной карты из [Получить тарифную
карту](https://docs.anivahealth.com/ru/api/pricing/get-rate-card.md). По умолчанию используется карта твоего платёжного аккаунта, иначе — розничная.
Для `retail_cents` всегда используется розничный тариф.

## Ответ

Возвращает массив панелей.

**id** `string`

UUID панели. Передай его в [Добавить панели](https://docs.anivahealth.com/ru/api/appointments/add-panels.md).

**name** `string`

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

**description** `string | null`

Для чего нужна панель, или `null`.

**biomarker\_ids** `number[]`

Все биомаркеры из `biomarker_groups` в одном списке. См. [Список
биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md).

**biomarker\_groups** `object[]`

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

**группа**

**biomarker\_ids** `number[]`

Взаимозаменяемые биомаркеры. Лаборатория измеряет один из них.

**required** `boolean`

Для твоего ключа всегда `true`.

**inclusion\_condition** `string | null`

Кому назначается группа, например `sex=2` или `age>50`, объединённые через `&&` или `||`. `sex` —
по ISO/IEC 5218 (1 — мужской, 2 — женский). `null` означает всех. [Предпросмотр
записи](https://docs.anivahealth.com/ru/api/appointments/preview-containers.md) применяет это условие к пациенту.

**pricing** `object | null`

Цена по твоей карте и в розницу. См. [объекты
цен](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md#obyekty-tsen). `null`, если у твоего ключа нет
`prices_view`. Для пользовательской панели `price_cents` равен `null`.

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

| Статус | Описание |
| - | - |
| `400` | Некорректный запрос, например неизвестный `rate_card`. |
| `403` | Нет разрешения `panels_access`. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/panels' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
[
  {
    "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
    "name": "Hormones (Female)",
    "description": "Cycle-related hormones for women, including thyroid.",
    "biomarker_ids": [42, 43, 44, 51],
    "biomarker_groups": [
      { "biomarker_ids": [42], "required": true, "inclusion_condition": null },
      { "biomarker_ids": [43, 44], "required": true, "inclusion_condition": null },
      { "biomarker_ids": [51], "required": true, "inclusion_condition": "sex=2" }
    ],
    "pricing": { "price_cents": 11900, "retail_cents": 14900 }
  },
  {
    "id": "9c1d2e3f-4a5b-4c7d-8e9f-0a1b2c3d4e5f",
    "name": "Custom",
    "description": null,
    "biomarker_ids": [],
    "biomarker_groups": [],
    "pricing": { "price_cents": null, "retail_cents": null }
  }
]
```


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