[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fitems\u002Fsearch":3,"docs-tabs-entities\u002Fitems\u002Fsearch":6},{"content":4,"lastmod":5},"\n## Поиск элементов смарт-процесса\n\n`POST \u002Fv1\u002Fitems\u002F:entityTypeId\u002Fsearch`\n\nРасширенный поиск элементов с фильтрацией, сортировкой и авто-пагинацией. Поддерживает до 5000 записей.\n\n## Поля запроса (body)\n\n| Параметр | Тип | Описание |\n|----------|-----|---------|\n| `filter` | object | Фильтрация по полям `GET \u002Fv1\u002Fitems\u002F:entityTypeId\u002Ffields`.\u003Cbr>[Синтаксис фильтрации](\u002Fdocs\u002Ffiltering). Пример: `{ \"filter\": { \"assignedById\": 1 } }` |\n| `sort` | string | Сортировка. Префикс `-` — по убыванию |\n| `limit` | number | Количество записей (по умолчанию 50, макс. 5000) |\n| `select` | array | Список возвращаемых полей |\n| `autoWindow` | boolean | Авто-разбивка по датам (по умолчанию `true`) |\n\n### Синтаксис фильтров\n\nПоддерживаются три формата:\n\n```json\n{ \"filter\": { \">=opportunity\": 100000 } }\n{ \"filter\": { \"opportunity\": { \"$gte\": 100000 } } }\n{ \"filter\": { \"opportunity\": { \">=\": 100000 } } }\n```\n\n## Примеры\n\nВ примерах `entityTypeId = 156` — замените на ID вашего смарт-процесса.\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fitems\u002F156\u002Fsearch \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"filter\": {\n      \"assignedById\": 1,\n      \"stageId\": \"DT156_41:NEW\"\n    },\n    \"select\": [\"id\", \"title\", \"opportunity\", \"stageId\"],\n    \"sort\": \"-createdTime\",\n    \"limit\": 100\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fitems\u002F156\u002Fsearch \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"filter\": {\n      \"assignedById\": 1,\n      \"stageId\": \"DT156_41:NEW\"\n    },\n    \"select\": [\"id\", \"title\", \"opportunity\", \"stageId\"],\n    \"sort\": \"-createdTime\",\n    \"limit\": 100\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fitems\u002F156\u002Fsearch', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    filter: { assignedById: 1, stageId: 'DT156_41:NEW' },\n    select: ['id', 'title', 'opportunity', 'stageId'],\n    sort: '-createdTime',\n    limit: 100,\n  }),\n})\n\nconst { success, data, meta } = await res.json()\nconsole.log(`Найдено: ${meta.total}`)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fitems\u002F156\u002Fsearch', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    filter: { assignedById: 1, stageId: 'DT156_41:NEW' },\n    select: ['id', 'title', 'opportunity', 'stageId'],\n    sort: '-createdTime',\n    limit: 100,\n  }),\n})\n\nconst { success, data, meta } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `data` | array | Массив элементов |\n| `meta.total` | number | Общее количество записей под фильтр |\n| `meta.hasMore` | boolean | Есть ли ещё страницы |\n| `meta.durationMs` | number | Время выполнения запроса в миллисекундах |\n\nURL карточки любого элемента из массива `data` — его `id`:\n\n```\nhttps:\u002F\u002F\u003Cportal>.bitrix24.ru\u002Fcrm\u002Ftype\u002F\u003CentityTypeId>\u002Fdetails\u002F\u003Cid>\u002F\n```\n\n`\u003CentityTypeId>` — ID типа смарт-процесса (тот же, что в пути запроса). `\u003Cportal>` — домен портала. Если смарт-процесс вынесен в отдельный раздел портала, Битрикс24 откроет карточку по соответствующему пути. Доступ ограничен правами сотрудника в Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": 783,\n      \"title\": \"Договор на поставку\",\n      \"stageId\": \"DT156_41:NEW\",\n      \"opportunity\": 500000\n    }\n  ],\n  \"meta\": { \"total\": 5, \"hasMore\": false, \"durationMs\": 320 }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'crm' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 400 | `INVALID_DYNAMIC_PARAM` | `entityTypeId` не является положительным целым или является зарезервированным (1, 2, 3, 4, 7, 31) |\n| 400 | `UNKNOWN_FILTER_FIELD` | Поле фильтра не существует у сущности — сообщение перечисляет доступные поля |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Список элементов](\u002Fdocs\u002Fentities\u002Fitems\u002Flist)\n- [Поля элемента](\u002Fdocs\u002Fentities\u002Fitems\u002Ffields)\n- [Пакетные запросы](\u002Fdocs\u002Fbatch)\n- [Смарт-процессы](\u002Fdocs\u002Fentities\u002Fsmart-processes)\n- [Entity API](\u002Fdocs\u002Fentity-api)\n","2026-07-07",{}]