Для AI-агентов: markdown этой страницы — /docs-content/lists/sections/get.md индекс документации — /llms.txt

Получить раздел

GET /v1/lists/:iblockId/sections/:sectionId

Возвращает раздел списка по его числовому идентификатору.

Параметры

Параметр	Тип	Обяз.	По умолч.	Описание
`iblockId` (path)	string	да	—	Идентификатор или символьный код списка. Значения — поля `ID` или `CODE` метода Список списков
`sectionId` (path)	number	да	—	Идентификатор раздела, положительное целое число из поля `ID` метода Разделы списка
`iblockTypeId` (query)	string	нет	`lists`	Тип инфоблока. Значения: `lists` — обычные списки, по умолчанию `lists_socnet` — списки рабочих групп `bitrix_processes` — служебные бизнес-процессы `structure` — тип структуры компании (здесь лежит штатный инфоблок графика отсутствий `absence`)
`socnetGroupId` (query)	number	нет	—	Идентификатор рабочей группы для списков типа `lists_socnet`. Положительное целое число из поля `id` метода Список рабочих групп. Для обычного списка не передавайте

Примеры

curl — личный ключ

Terminal

curl https://vibecode.bitrix24.tech/v1/lists/165/sections/259 \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal

curl https://vibecode.bitrix24.tech/v1/lists/165/sections/259 \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/lists/165/sections/259', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { data } = await res.json()
console.log('Раздел:', data.NAME)

JavaScript — OAuth-приложение

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/lists/165/sections/259', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()

Поля ответа

Числовые значения и флаги Y/N приходят строками. Поля meta в ответе нет.

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data`	object	Объект раздела
`data.ID`	string	Идентификатор раздела из метода Разделы списка
`data.NAME`	string	Название раздела
`data.CODE`	string или null	Символьный код раздела или `null`, если не задан
`data.IBLOCK_ID`	string	Идентификатор списка из метода Список списков
`data.IBLOCK_SECTION_ID`	string или null	Идентификатор родительского раздела из метода Разделы списка. `null` у корневого раздела
`data.SORT`	string	Индекс сортировки
`data.ACTIVE`	string	Собственная активность раздела: `Y` или `N`
`data.GLOBAL_ACTIVE`	string	Активность с учётом родительских разделов: `Y` или `N`. Если родитель отключён, у потомка — `N`, даже когда его собственный `ACTIVE` равен `Y`
`data.DEPTH_LEVEL`	string	Уровень вложенности. `1` у корневого раздела
`data.LEFT_MARGIN`	string	Левая граница поддерева в модели вложенных множеств
`data.RIGHT_MARGIN`	string	Правая граница поддерева в модели вложенных множеств
`data.DESCRIPTION`	string или null	Описание раздела или `null`, если не задано
`data.DESCRIPTION_TYPE`	string	Формат описания: `text` или `html`
`data.DATE_CREATE`	string или null	Дата и время создания в формате портала или `null`, если не заданы
`data.CREATED_BY`	string или null	Идентификатор создавшего раздел сотрудника из метода Список сотрудников или `null`, если не задан
`data.MODIFIED_BY`	string или null	Идентификатор последнего изменившего раздел сотрудника из метода Список сотрудников или `null`, если не задан
`data.TIMESTAMP_X`	string	Дата и время последнего изменения в формате портала
`data.PICTURE`	string или null	Идентификатор файла изображения раздела или `null`, если изображение не задано
`data.DETAIL_PICTURE`	string или null	Идентификатор файла детального изображения раздела или `null`, если изображение не задано
`data.SEARCHABLE_CONTENT`	string или null	Текст для поиска по разделу, сформированный из названия и описания, или `null`, если не задан
`data.XML_ID`	string или null	Внешний идентификатор раздела для обмена данными или `null`, если не задан
`data.EXTERNAL_ID`	string или null	То же значение, что в `XML_ID`
`data.TMP_ID`	string или null	Временный идентификатор раздела для служебных операций или `null`, если не задан
`data.SOCNET_GROUP_ID`	string или null	Идентификатор рабочей группы из метода Список рабочих групп или `null`, если не задан
`data.LIST_PAGE_URL`	string или null	Шаблон адреса страницы списка из настроек списка или `null`, если не задан
`data.SECTION_PAGE_URL`	string или null	Шаблон адреса страницы раздела из настроек списка или `null`, если не задан
`data.IBLOCK_TYPE_ID`	string	Тип инфоблока
`data.IBLOCK_CODE`	string или null	Символьный код списка из метода Список списков или `null`, если не задан
`data.IBLOCK_EXTERNAL_ID`	string или null	Внешний идентификатор списка для обмена данными или `null`, если не задан

Пример ответа

JSON

{
  "success": true,
  "data": {
    "ID": "259",
    "TIMESTAMP_X": "10/07/2026 08:53:57 am",
    "MODIFIED_BY": "1295",
    "DATE_CREATE": "10/07/2026 08:53:57 am",
    "CREATED_BY": "1295",
    "IBLOCK_ID": "165",
    "IBLOCK_SECTION_ID": null,
    "ACTIVE": "Y",
    "GLOBAL_ACTIVE": "Y",
    "SORT": "100",
    "NAME": "Документы отдела продаж",
    "PICTURE": null,
    "LEFT_MARGIN": "1",
    "RIGHT_MARGIN": "4",
    "DEPTH_LEVEL": "1",
    "DESCRIPTION": "Описание раздела",
    "DESCRIPTION_TYPE": "html",
    "SEARCHABLE_CONTENT": "ДОКУМЕНТЫ ОТДЕЛА ПРОДАЖ\r\nОПИСАНИЕ РАЗДЕЛА",
    "CODE": "sales_docs",
    "XML_ID": null,
    "TMP_ID": null,
    "DETAIL_PICTURE": null,
    "SOCNET_GROUP_ID": null,
    "LIST_PAGE_URL": null,
    "SECTION_PAGE_URL": null,
    "IBLOCK_TYPE_ID": "lists",
    "IBLOCK_CODE": "sales_documents",
    "IBLOCK_EXTERNAL_ID": null,
    "EXTERNAL_ID": null
  }
}

Пример ответа при ошибке

404 — раздел не найден: