Битрикс24 REST API: Выгрузить все сделки на нужной стадии

Сценарий из mcp-everything. Актуально на 2026-10-24.

Забрать сделки из Битрикс24 в свою аналитику или учётную систему.

Запроси список: crm.item.list с entityTypeId = 2, filter (например, по stageId или по дате изменения) и select с нужными полями — так ответ будет легче.
Страница всегда содержит 50 записей. Следующую получай с параметром start = 50, 100 и так далее, пока в ответе есть next.
Для больших выгрузок собирай до 50 вызовов crm.item.list с разными start в один batch — это в десятки раз быстрее отдельных запросов.
Учитывай лимит частоты: на обычных тарифах — примерно 2 запроса в секунду. При превышении приходит HTTP 503 с QUERY_LIMIT_EXCEEDED — подожди и повтори.

curl -X POST "$HOOK/crm.item.list.json" \
  -H 'Content-Type: application/json' \
  -d '{
        "entityTypeId": 2,
        "select": ["id", "title", "stageId", "opportunity", "currencyId", "contactIds", "updatedTime"],
        "filter": {"stageId": "WON", ">=updatedTime": "2026-01-01T00:00:00+03:00"},
        "order": {"id": "ASC"},
        "start": 0
      }'

Базовые URL

Боевой (входящий вебхук): https://<ваш-портал>.bitrix24.ru/rest/<id пользователя>/<код вебхука>/<метод>.json
Боевой (приложение OAuth 2.0): https://<ваш-портал>.bitrix24.ru/rest/<метод>.json
Сервер авторизации OAuth: https://oauth.bitrix.info/

Авторизация

Тип: Другое

Два способа:

Входящий вебхук — постоянный секретный код в URL запроса вместе с ID пользователя, создавшего вебхук. Метод выполняется с правами этого пользователя и в рамках выбранных в настройках вебхука скоупов. Подходит для интеграции с одним порталом. Код вебхука — это пароль: не публикуйте его и не передавайте в браузерный код.
OAuth 2.0 — для локальных и тиражных приложений. Временный access_token передаётся в параметре auth; живёт один час и обновляется через https://oauth.bitrix.info/oauth/token/ с помощью refresh_token. client_secret используется только в запросах к oauth.bitrix.info.

Без данных авторизации запрос отклоняется с ошибкой NO_AUTH_FOUND.

curl -X POST \
-H "Content-Type: application/json" \
-d '{
	"entityTypeId": 2,
	"fields": {
		"title": "New Deal",
		"typeId": "SALE",
		"stageId": "NEW"
	}
}' \
https://your-domain.bitrix24.com/rest/1/8g9l071eismy9q2l/crm.item.add.json

Методы сценария

crm.item.list — Список элементов

Возвращает только элементы, на которые у пользователя есть право чтения. Размер страницы всегда 50 записей.

Пример ответа (сокращён):

Параметр	Где	Тип	Обяз.	Описание
`entityTypeId`	body	integer	да	Тип объекта CRM
`select`	body	array	нет	Поля для выборки или '*'
`filter`	body	object	нет	Фильтр вида {поле: значение}, допускает вложенность и логику
`order`	body	object	нет	Сортировка вида {поле: "ASC" \| "DESC"}
`start`	body	integer	нет	Смещение для пагинации: 50 — вторая страница
`useOriginalUfNames`	body	boolean	нет	Формат имён пользовательских полей

Пример запроса:

{
    "result": {
        "items": [
            {
                "id": 253,
                "assignedById": 6,
                "stageId": "NEW",
                "opportunity": 19000,
                "sourceId": "WEB",
                "title": "Lead #253",
                "name": "Admin",
                "lastName": null,
                "isManualOpportunity": "Y"
            }
        ]
    }
}

batch — Пакетный запрос

Выполняет несколько вызовов за один HTTP-запрос — независимых или связанных (результат одного передаётся в следующий). Скоуп basic. В одном batch — не больше 50 команд.

Параметр	Где	Тип	Обяз.	Описание
`cmd`	body	array	да	Подзапросы: ключ — идентификатор, значение — строка method?parameter=value
`halt`	body	boolean	нет	Прерывать последовательность при ошибке

Нюансы

Методы crm.deal.*, crm.lead.* и аналогичные больше не развиваются; для новых интеграций используйте crm.item.*.
Ошибку распознают по полям ответа, а не по HTTP-статусу: подзапросы batch с ошибкой приходят со статусом 200, а поле error может быть пустым — тогда причина только в error_description.
В ответе batch поле result.result_error есть всегда; признак ошибки — непустое содержимое.
Методы *.list отдают по 50 записей; для больших выгрузок используйте пагинацию без подсчёта общего количества и batch.
Некоторые методы (например placement.bind, event.bind) недоступны вебхуку и возвращают WRONG_AUTH_TYPE.
Несколько приложений с одного сервера к одному порталу делят общий лимит частоты запросов — лимит учитывает IP-адрес источника.
Запрос по http вместо https вернёт INVALID_REQUEST.
У Битрикс24 есть MCP-сервер b24-dev-mcp для AI-инструментов: он даёт доступ к официальной документации REST API (без доступа к данным портала).

Другие сценарии

Если этого недостаточно — официальная документация: https://apidocs.bitrix24.ru/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/bitrix24.md