# Список CRM-форм

`GET /v1/crm-forms` вызывает `crm.form.list`. Нужны ключ API Вайбкод и скоуп `crm`; ключ READONLY подходит.

| Параметр | Значение |
|---|---|
| `active` | Необязательное `true`/`false` или `1`/`0`. Без параметра Битрикс24 возвращает только активные формы. |
| `isCallback` | Необязательное `true`/`false` или `1`/`0`. |

Ответ содержит массив `data` из объектов `{ id, name }` и `meta.total`. Порядок — ID по убыванию, пагинации нет. Например, `GET /v1/crm-forms?active=false` ищет неактивные формы.

Битрикс24 без права просмотра форм молча отдаёт пустой список. `data: []` само по себе не доказывает, что форм нет.

Ошибки: `400 UNKNOWN_FILTER_FIELD` для неизвестного параметра, `400 INVALID_PARAMS` для неверного или повторённого булева фильтра, `403 SCOPE_DENIED`, `422 BITRIX_ERROR` для отказа Битрикс24. Общие ошибки ключа, квоты и доступности описаны в [Ошибках](/docs/errors).