# lists.element.get URL: https://chugunov.pro/api-bitrix24/lists/elements/lists-element-get/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Получить параметры элемента или список элементов Scope: `lists` Кто может выполнять метод: пользователь с правом «Чтение» для нужного списка ## Описание Метод `lists.element.get` возвращает элемент или список элементов. ## Параметры - `IBLOCK_TYPE_ID` `string` — обязательный. Идентификатор типа инфоблока. Стандартные типы: - `lists` — универсальные списки - `bitrix_processes` — процессы - `lists_socnet` — списки групп В коробочной версии можно также указать идентификатор произвольного существующего типа инфоблоков. `IBLOCK_ID` или `IBLOCK_CODE` должен указывать на инфоблок этого типа. Доступ к операции определяется стандартными правами пользователя на инфоблок, раздел или элемент - `IBLOCK_ID` `integer` — обязательный. Идентификатор инфоблока. Идентификатор можно получить с помощью метода [lists.get](https://chugunov.pro/api-bitrix24/lists/lists/lists-get/) - `IBLOCK_CODE` `string` — обязательный. Cимвольный код инфоблока. Код можно получить с помощью метода [lists.get](https://chugunov.pro/api-bitrix24/lists/lists/lists-get/) Необходимо указать хотя бы один из параметров: `IBLOCK_ID` или `IBLOCK_CODE` - `ELEMENT_ID` `integer` — необязательный. Идентификатор элемента. Идентификатор можно получить с помощью метода [lists.element.get](https://chugunov.pro/api-bitrix24/lists/elements/lists-element-get/) - `ELEMENT_CODE` `string` — необязательный. Символьный код элемента. Код можно получить с помощью метода [lists.element.get](https://chugunov.pro/api-bitrix24/lists/elements/lists-element-get/) Чтобы получить данные элемента, необходимо указать хотя бы один из параметров: `ELEMENT_ID` и `ELEMENT_CODE` - `SELECT` `array` — необязательный. Массив содержит список полей, которые необходимо выбрать. Если поля не указаны, возвращаются все доступные по умолчанию. Доступные поля: - `ID` — идентификатор элемента - `CODE` — код элемента - `NAME` — название элемента - `IBLOCK_SECTION_ID` — идентификатор раздела, в который добавляется элемент - `CREATED_BY` — идентификатор пользователя, создавшего элемент - `CREATED_USER_NAME` — имя пользователя, создавшего элемент (устаревшее) - `ACTIVE_TO` — дата окончания активности (устаревшее) - `BP_PUBLISHED` — публикация в рамках бизнес-процесса (устаревшее) - `DATE_CREATE` — дата создания элемента - `PREVIEW_TEXT` — текст анонса (устаревшее) - `DETAIL_TEXT` — детальный текст (устаревшее) - `SORT` — сортировка - `PREVIEW_TEXT_TYPE` — тип текста анонса (устаревшее) - `DETAIL_TEXT_TYPE` — тип детального текста (устаревшее) - `PROPERTY_PropertyId` — пользовательские свойства Идентификатор свойства можно получить с помощью метода [lists.field.get](https://chugunov.pro/api-bitrix24/lists/fields/lists-field-get/). - `FILTER` `object` — необязательный. Объект для фильтрации полей элементов в формате `{"field_1": "value_1", ... "field_N": "value_N"}`. Фильтруемое поле может принимать значения: - `NAME` — название элемента - `IBLOCK_SECTION_ID` — идентификатор раздела, в который добавляется элемент - `CREATED_BY` — идентификатор пользователя, создавшего элемент - `ACTIVE_TO` — дата окончания активности (устаревшее) - `BP_PUBLISHED` — публикация в рамках бизнес-процесса (устаревшее) - `DATE_CREATE` — дата создания элемента - `PREVIEW_TEXT` — текст анонса (устаревшее) - `DETAIL_TEXT` — детальный текст (устаревшее) - `SORT` — сортировка - `PREVIEW_TEXT_TYPE` — тип текста анонса (устаревшее) - `DETAIL_TEXT_TYPE` — тип детального текста (устаревшее) - `PROPERTY_PropertyId` — пользовательские свойства Идентификатор свойства можно получить с помощью метода [lists.field.get](https://chugunov.pro/api-bitrix24/lists/fields/lists-field-get/). Ключу можно задать дополнительный префикс, уточняющий поведение фильтра. Возможные значения префикса: - `>=` — больше либо равно - `>` — больше - `<=` — меньше либо равно - `<` — меньше - `=` — точное совпадение - `!=`, `!` — не равно - `@` — IN, в качестве значения передается массив - `!@` — NOT IN, в качестве значения передается массив - `%` — LIKE, поиск по подстроке. Символ `%` в значении фильтра передавать не нужно. Поиск ищет подстроку в любой позиции строки - `=%` — LIKE, поиск по подстроке. Символ `%` нужно передавать в значении. Примеры: - `"мол%"` — ищет значения, начинающиеся с «мол» - `"%мол"` — ищет значения, заканчивающиеся на «мол» - `"%мол%"` — ищет значения, где «мол» может быть в любой позиции - `!%` — NOT LIKE, поиск по подстроке. Символ `%` в значении фильтра передавать не нужно. Поиск идет с обеих сторон - `!=%` — NOT LIKE, поиск по подстроке. Символ `%` нужно передавать в значении. Примеры: - `"мол%"` — ищет значения, не начинающиеся с «мол» - `"%мол"` — ищет значения, не заканчивающиеся на «мол» - `"%мол%"` — ищет значения, где подстроки «мол» нет в любой позиции - `=` — равно, точное совпадение, используется по умолчанию - `!=` — не равно - `!` — не равно Если не передать идентификатор элемента и не задать условия для фильтрациии, будут возвращены все элементы списка - `ELEMENT_ORDER` `object` — необязательный. Объект для сортировки полей элементов в формате `{"field_1": "value_1", ... "field_N": "value_N"}`. Направление сортировки может принимать значения: - `asc` — по возрастанию - `desc` — по убыванию Не поддерживается сортировка множественных свойств, а также свойств: - `S:Money` — тип деньги - `PREVIEW_TEXT` - `DETAIL_TEXT` - `S:ECrm` — тип привязка к элементам CRM - `S:map_yandex` — тип привязка к Яндекс.Карте - `S:DiskFile` — тип Файл (Диск) - `IBLOCK_SECTION_ID` - `start` `integer` — необязательный. Параметр используется для управления постраничной навигацией. Размер страницы результатов всегда статичный — 50 записей. Чтобы выбрать вторую страницу результатов, необходимо передавать значение `50`. Чтобы выбрать третью страницу результатов — значение `100` и так далее. Формула расчета значения параметра `start`: `start = (N - 1) * 50`, где `N` — номер нужной страницы ## Ответ HTTP-статус: 200 ```json { "result": [ { "ID": "6999", "NAME": "Тестовый элемент", "IBLOCK_SECTION_ID": null, "CREATED_BY": "1269", "CODE": "test_element", "PROPERTY_951": { "3743": "1269", "3745": "1271" }, "PROPERTY_1003": { "3747": "12/31/2024 11:59:59 pm" } } ], "total": 1, "time": { "start": 1763656328, "finish": 1763656328.442951, "duration": 0.442950963973999, "processing": 0, "date_start": "2025-11-19T14:32:08+03:00", "date_finish": "2025-11-19T14:32:08+03:00", "operating_reset_at": 1763656928, "operating": 0 } } ``` ### Возвращаемые данные - `result` `array`. Данные элемента или массив элементов. Результат зависит от параметра SELECT. Пустой массив означает, что в списке нет элементов, либо элементы не соответствуют фильтру - `total` `integer`. Общее количество элементов - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error":"ERROR_REQUIRED_PARAMETERS_MISSING", "error_description":"Required parameter is missing" } ``` - `ERROR_REQUIRED_PARAMETERS_MISSING` — Required parameter `X` is missing. Обязательный параметр не передан - `ERROR_IBLOCK_NOT_FOUND` — Iblock not found. Инфоблок не найден - `ACCESS_DENIED` — Access denied. Недостаточно прав для чтения элемента ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":47,"ELEMENT_ID":6999,"SELECT":["ID","CODE","NAME","IBLOCK_SECTION_ID","DATE_CREATE","PROPERTY_951","PROPERTY_1003"],"FILTER":{"NAME":"%Тестовый%","<=DATE_CREATE":"2025-12-31",">=DATE_CREATE":"2025-01-01"},"ELEMENT_ORDER":{"NAME":"asc"},"start":0}' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/lists.element.get ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":47,"ELEMENT_ID":6999,"SELECT":["ID","CODE","NAME","IBLOCK_SECTION_ID","DATE_CREATE","PROPERTY_951","PROPERTY_1003"],"FILTER":{"NAME":"%Тестовый%","<=DATE_CREATE":"2025-12-31",">=DATE_CREATE":"2025-01-01"},"ELEMENT_ORDER":{"NAME":"asc"},"start":0,"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/lists.element.get ``` ### JS (TS) ```ts // This snippet is an ES module: top-level await requires type="module" or a bundler. // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide). import { Text } from '@bitrix24/b24jssdk' import type { B24Frame } from '@bitrix24/b24jssdk' declare const $b24: B24Frame // Shape of each element returned in result[] type ElementData = { ID: string NAME: string CODE: string IBLOCK_SECTION_ID: string | null CREATED_BY: string PROPERTY_951: Record PROPERTY_1003: Record } try { // lists.element.get returns a single page (max 50 records). For the whole result set // use a list helper: $b24.actions.v2.callList.make() returns every record as one // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator). // NOTE: the list helpers do not accept `order` (it is excluded from their params, so // passing it is a TS error) — keep this call.make + `start` variant when sort matters. const response = await $b24.actions.v2.call.make({ method: 'lists.element.get', params: { IBLOCK_TYPE_ID: 'lists', IBLOCK_ID: 47, ELEMENT_ID: 6999, SELECT: [ 'ID', 'CODE', 'NAME', 'IBLOCK_SECTION_ID', 'DATE_CREATE', 'PROPERTY_951', 'PROPERTY_1003', ], FILTER: { NAME: '%Test%', '>=DATE_CREATE': '2025-01-01', '<=DATE_CREATE': '2025-12-31', }, ELEMENT_ORDER: { NAME: 'asc', }, start: 0, }, requestId: Text.getUuidRfc4122() }) // The payload is available only on a successful response if (!response.isSuccess) { console.error(response.getErrorMessages().join('; ')) } else { const result = response.getData()!.result console.info('Fetched elements:', result.length, result[0]?.ID, result[0]?.NAME) } } catch (error) { // Thrown on transport or SDK failures (AjaxError, SdkError, etc.) console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from b24pysdk.errors import BitrixAPIError, BitrixSDKException select = [ "ID", "CODE", "NAME", "IBLOCK_SECTION_ID", "DATE_CREATE", "PROPERTY_951", "PROPERTY_1003", ] filter = { "NAME": "%Тестовый%", "<=DATE_CREATE": "2025-12-31", ">=DATE_CREATE": "2025-01-01", } element_order = { "NAME": "asc", } try: bitrix_response = client.lists.element.get( iblock_type_id='lists', iblock_id=47, element_id=6999, select=select, filter=filter, element_order=element_order, start=0, ).response result = bitrix_response.result print(result) except BitrixAPIError as error: print( "Ошибка Bitrix API", f"error: {error.error}", f"error_description: {error.error_description}", sep="\n", ) except BitrixSDKException as error: print(f"Ошибка Bitrix SDK: {error.message}") except Exception as error: print(f"Непредвиденная ошибка: {error}") ``` ### PHP ```php try { $response = $b24Service ->core ->call( 'lists.element.get', [ 'IBLOCK_TYPE_ID' => 'lists', 'IBLOCK_ID' => 47, 'ELEMENT_ID' => 6999, 'SELECT' => [ 'ID', 'CODE', 'NAME', 'IBLOCK_SECTION_ID', 'DATE_CREATE', 'PROPERTY_951', 'PROPERTY_1003' ], 'FILTER' => [ 'NAME' => '%Тестовый%', '>=DATE_CREATE' => '2025-01-01', '<=DATE_CREATE' => '2025-12-31' ], 'ELEMENT_ORDER' => [ 'NAME' => 'asc' ], 'start' => 0 ] ); $result = $response ->getResponseData() ->getResult(); echo 'Success: ' . print_r($result, true); processData($result); } catch (Throwable $e) { error_log($e->getMessage()); echo 'Error fetching list element: ' . $e->getMessage(); } ``` ### BX24.js ```js BX24.callMethod( "lists.element.get", { IBLOCK_TYPE_ID: 'lists', IBLOCK_ID: 47, ELEMENT_ID: 6999, SELECT: [ 'ID', 'CODE', 'NAME', `IBLOCK_SECTION_ID`, 'DATE_CREATE', 'PROPERTY_951', 'PROPERTY_1003' ], FILTER: { NAME: '%Тестовый%', '>=DATE_CREATE': '2025-01-01', '<=DATE_CREATE': '2025-12-31' }, ELEMENT_ORDER: { NAME: 'asc' } }, function(res) { if (res.error()) { console.error(res.error()); } else { console.log(res.data()); if (res.more()) { res.next(); } } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'lists.element.get', [ 'IBLOCK_TYPE_ID' => 'lists', 'IBLOCK_ID' => 47, 'ELEMENT_ID' => 6999, 'SELECT' => [ 'ID', 'CODE', 'NAME', 'IBLOCK_SECTION_ID', 'DATE_CREATE', 'PROPERTY_951', 'PROPERTY_1003' ], 'FILTER' => [ 'NAME' => '%Тестовый%', '>=DATE_CREATE' => '2025-01-01', '<=DATE_CREATE' => '2025-12-31' ], 'ELEMENT_ORDER' => [ 'NAME' => 'asc' ], 'start' => 0 ] ); echo '
';
print_r($result);
echo '
'; ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "lists.element.get", b24.Params{ "IBLOCK_TYPE_ID": "lists", "IBLOCK_ID": 47, "ELEMENT_ID": 6999, "SELECT": []string{"ID", "CODE", "NAME", "IBLOCK_SECTION_ID", "DATE_CREATE", "PROPERTY_951", "PROPERTY_1003"}, "FILTER": b24.Params{ "NAME": "%Тестовый%", "<=DATE_CREATE": "2025-12-31", ">=DATE_CREATE": "2025-01-01", }, "ELEMENT_ORDER": b24.Params{ "NAME": "asc", }, "start": 0, }, b24.WithIdempotent()) if err != nil { return fmt.Errorf("lists.element.get: %w", err) } var items []struct { ID b24.ID `json:"ID"` Name string `json:"NAME"` CreatedBy string `json:"CREATED_BY"` Code string `json:"CODE"` } if err := json.Unmarshal(res.Result, &items); err != nil { return fmt.Errorf("разбор ответа: %w", err) } for _, it := range items { fmt.Println(it.ID, it.Name) } ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/lists/elements/lists-element-get.html