[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-lists\u002Fsections\u002Fget":3,"docs-tabs-lists\u002Fsections\u002Fget":6},{"content":4,"lastmod":5},"## Получить раздел\n\n`GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections\u002F:sectionId`\n\nВозвращает полные метаданные одного раздела списка по его числовому идентификатору.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|:---------:|---------|\n| `iblockId` (path) | string | да | — | Числовой `IBLOCK_ID` или символьный код списка. Идентификаторы доступны через `GET \u002Fv1\u002Flists` |\n| `sectionId` (path) | number | да | — | Числовой идентификатор раздела. Идентификаторы доступны через `GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections` |\n| `iblockTypeId` (query) | string | нет | `lists` | Тип инфоблока. Значения:\u003Cbr>`lists` — обычные списки, по умолчанию\u003Cbr>`lists_socnet` — списки рабочих групп\u003Cbr>`bitrix_processes` — служебные бизнес-процессы |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections\u002F137 \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections\u002F137 \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections\u002F137', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\nconsole.log('Раздел:', data.NAME)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections\u002F137', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\nПоля ответа — в форме Битрикс24: ключи в верхнем регистре через подчёркивание, числовые значения и флаги (`Y`\u002F`N`) приходят строками, незаданные поля — `null`.\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.ID` | string | Идентификатор раздела |\n| `data.NAME` | string | Название раздела |\n| `data.CODE` | string | Символьный код раздела |\n| `data.IBLOCK_ID` | string | Идентификатор списка, которому принадлежит раздел |\n| `data.IBLOCK_SECTION_ID` | string | Идентификатор родительского раздела. Приходит `null` у корневого раздела |\n| `data.SORT` | string | Индекс сортировки |\n| `data.ACTIVE` | string | Активность раздела: `Y` или `N` |\n| `data.GLOBAL_ACTIVE` | string | Действующая активность с учётом родительских разделов: `Y` или `N` |\n| `data.DEPTH_LEVEL` | string | Уровень вложенности. `1` у корневого раздела |\n| `data.LEFT_MARGIN` | string | Левая граница поддерева в модели вложенных множеств |\n| `data.RIGHT_MARGIN` | string | Правая граница поддерева в модели вложенных множеств |\n| `data.DESCRIPTION` | string | Описание раздела |\n| `data.DESCRIPTION_TYPE` | string | Формат описания: `text` или `html` |\n| `data.DATE_CREATE` | string | Дата создания |\n| `data.CREATED_BY` | string | Идентификатор сотрудника, создавшего раздел |\n| `data.MODIFIED_BY` | string | Идентификатор сотрудника, изменившего раздел последним |\n\nПоказаны основные поля. Объект раздела содержит и другие поля метаданных инфоблока Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"ID\": \"137\",\n    \"NAME\": \"Документы отдела продаж\",\n    \"CODE\": \"sales_docs\",\n    \"IBLOCK_ID\": \"121\",\n    \"IBLOCK_SECTION_ID\": null,\n    \"ACTIVE\": \"Y\",\n    \"GLOBAL_ACTIVE\": \"Y\",\n    \"SORT\": \"100\",\n    \"DEPTH_LEVEL\": \"1\",\n    \"LEFT_MARGIN\": \"1\",\n    \"RIGHT_MARGIN\": \"2\",\n    \"DESCRIPTION\": \"Описание раздела\",\n    \"DESCRIPTION_TYPE\": \"html\",\n    \"DATE_CREATE\": \"10\u002F22\u002F2025 04:22:38 am\",\n    \"CREATED_BY\": \"1\",\n    \"MODIFIED_BY\": \"1\",\n    \"TIMESTAMP_X\": null,\n    \"PICTURE\": null,\n    \"IBLOCK_TYPE_ID\": \"lists\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n404 — раздел не найден:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SECTION_NOT_FOUND\",\n    \"message\": \"Section not found\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `sectionId` не является положительным целым числом |\n| 400 | `INVALID_IBLOCK_TYPE` | `iblockTypeId` не входит в допустимый набор |\n| 404 | `SECTION_NOT_FOUND` | Раздел с указанным `sectionId` не найден |\n| 403 | `BITRIX_ACCESS_DENIED` | Нет прав на список либо списка с таким идентификатором не существует |\n| 409 | `LISTS_MODULE_NOT_ENABLED` | Модуль «Списки» не подключён на портале |\n| 403 | `SCOPE_DENIED` | У API-ключа нет скоупа `lists` |\n| 401 | `TOKEN_MISSING` | У API-ключа нет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Положение раздела в дереве задаётся тремя полями.** `DEPTH_LEVEL` — уровень вложенности, `1` у корневого раздела. `LEFT_MARGIN` и `RIGHT_MARGIN` — границы поддерева в модели вложенных множеств. По ним Битрикс24 определяет потомков раздела: раздел является потомком другого, если его границы лежат внутри границ предка.\n\n**`ACTIVE` и `GLOBAL_ACTIVE` различаются.** `ACTIVE` — собственная активность раздела. `GLOBAL_ACTIVE` учитывает родительские разделы: если родитель отключён, у потомка приходит `GLOBAL_ACTIVE` равный `N` даже при `ACTIVE` равном `Y`.\n\n## Смотрите также\n\n- [Разделы списка](\u002Fdocs\u002Flists\u002Fsections\u002Flist)\n- [Обновить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fupdate)\n- [Удалить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fdelete)\n","2026-07-07",{}]