[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Ffolders\u002Flist":3,"docs-tabs-entities\u002Ffolders\u002Flist":6},{"content":4,"lastmod":5},"## Список содержимого папки\n\n`GET \u002Fv1\u002Ffolders`\n\nВозвращает содержимое папки — вложенные подпапки и файлы. Параметр `parentId` обязателен — без него запрос возвращается с `400`.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|-----------|----------|\n| `parentId` (query) | number | да | | ID папки, чьё содержимое перечисляется. Корневая папка хранилища — поле `rootFolderId` в `GET \u002Fv1\u002Fstorages` |\n| `filter` (query) | object | нет | | Фильтрация по полям `GET \u002Fv1\u002Ffolders\u002Ffields`.\u003Cbr>[Синтаксис фильтрации](\u002Fdocs\u002Ffiltering). Пример: `?filter[type]=folder` |\n| `select` (query) | string | нет | все поля | Список возвращаемых полей через запятую. Пример: `?select=id,name` |\n| `order` (query) | object | нет | | Сортировка по полю. Пример: `?order[name]=asc` |\n| `limit` (query) | number | нет | 50 | Сколько записей вернуть. Максимум 5000 |\n| `offset` (query) | number | нет | 0 | Смещение для постраничной выборки |\n\nДля `limit > 50` Вайбкод автоматически пагинирует запрос на стороне сервера. Максимум — 5000 записей за вызов. Если под фильтр попадает больше, в `meta.hasMore` придёт `true`.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffolders?parentId=27&limit=10\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffolders?parentId=27&limit=10\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst params = new URLSearchParams({ parentId: '27', limit: '10' })\nconst res = await fetch(`https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffolders?${params}`, {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data, meta } = await res.json()\nconsole.log('Записей:', data.length, 'всего:', meta.total)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst params = new URLSearchParams({ parentId: '27', limit: '10' })\nconst res = await fetch(`https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffolders?${params}`, {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data, meta } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | array | Массив записей — подпапки (`type: \"folder\"`) и файлы (`type: \"file\"`). Все поля — см. [Поля папки](.\u002Ffields.md) |\n| `data[].type` | string | Тип записи: `\"folder\"` или `\"file\"`. Различает две схемы строк в одном массиве |\n| `meta.total` | number | Общее количество записей в папке |\n| `meta.hasMore` | boolean | Есть ли ещё записи за пределами `limit` |\n\nЗаписи-файлы несут собственный набор полей — `fileId`, `size`, `globalContentVersion`, `downloadUrl`, `folderId` — и не содержат `realObjectId`. Управление файлами — в разделе [Файлы](\u002Fdocs\u002Fentities\u002Ffiles).\n\nПоле `detailUrl` — полный URL карточки папки в Битрикс24, например `https:\u002F\u002F\u003Cportal>.bitrix24.ru\u002Fcompany\u002Fpersonal\u002Fuser\u002F1\u002Fdisk\u002Fpath\u002F\u003Cимя>\u002F`. `\u003Cportal>` — домен портала. Доступ ограничен правами сотрудника в Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": 9301,\n      \"name\": \"Документы\",\n      \"code\": null,\n      \"storageId\": 1,\n      \"type\": \"folder\",\n      \"realObjectId\": 9301,\n      \"parentId\": 27,\n      \"deletedType\": 0,\n      \"createdAt\": \"2026-06-25T12:10:00.000Z\",\n      \"updatedAt\": \"2026-06-25T12:10:00.000Z\",\n      \"deletedAt\": null,\n      \"createdBy\": 1,\n      \"updatedBy\": 1,\n      \"deletedBy\": 0,\n      \"detailUrl\": \"https:\u002F\u002F\u003Cportal>.bitrix24.ru\u002Fcompany\u002Fpersonal\u002Fuser\u002F1\u002Fdisk\u002Fpath\u002FДокументы\"\n    },\n    {\n      \"id\": 205,\n      \"name\": \"отчёт.pdf\",\n      \"code\": null,\n      \"storageId\": 1,\n      \"type\": \"file\",\n      \"folderId\": 27,\n      \"deletedType\": 0,\n      \"globalContentVersion\": 1,\n      \"fileId\": 363,\n      \"size\": 31232,\n      \"createdAt\": \"2020-05-15T09:29:09.000Z\",\n      \"updatedAt\": \"2020-05-15T09:29:09.000Z\",\n      \"deletedAt\": null,\n      \"createdBy\": 1,\n      \"updatedBy\": 1,\n      \"deletedBy\": 0,\n      \"downloadUrl\": \"https:\u002F\u002F\u003Cportal>.bitrix24.ru\u002Frest\u002F1\u002F****\u002Fdownload\u002F?token=****\"\n    }\n  ],\n  \"meta\": { \"total\": 22, \"hasMore\": true }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не передан обязательный `parentId`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"MISSING_REQUIRED_PARAMS\",\n    \"message\": \"GET \u002Fv1\u002Ffolders requires query parameters: parentId. Example: GET \u002Fv1\u002Ffolders?parentId=...\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_REQUIRED_PARAMS` | Не передан обязательный `parentId` |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `disk` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов портала |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n`GET \u002Fv1\u002Ffolders` перечисляет детей одной папки, заданной через `parentId`. Это не плоский список всех папок хранилища — для обхода дерева запрашивайте каждую папку отдельно по её `id`. Корневую папку хранилища даёт поле `rootFolderId` в `GET \u002Fv1\u002Fstorages`.\n\n## Смотрите также\n\n- [Получить папку](\u002Fdocs\u002Fentities\u002Ffolders\u002Fget)\n- [Создать папку](\u002Fdocs\u002Fentities\u002Ffolders\u002Fcreate)\n- [Поля папки](\u002Fdocs\u002Fentities\u002Ffolders\u002Ffields)\n- [Файлы](\u002Fdocs\u002Fentities\u002Ffiles)\n- [Хранилища](\u002Fdocs\u002Fentities\u002Fstorages)\n- [Синтаксис фильтрации](\u002Fdocs\u002Ffiltering)\n","2026-07-07",{}]