b24_lists_element_list
Read-onlyIdempotent
Retrieve list elements (records) from a Bitrix24 information block with pagination, filtering, sorting, and field selection. Supports auto-pagination to fetch all matching records.
Instructions
List elements (records) of a list (lists.element.get) with pagination.
Field codes are usually PROPERTY_ for custom properties plus NAME, ID, CREATED_BY, etc. Use b24_call('lists.field.get', ...) to inspect field codes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order | No | Sort object, e.g. {'ID':'DESC'} or {'DATE_CREATE':'ASC'}. | |
| start | No | Pagination offset (page size is 50). Use 'next' from a prior response. | |
| filter | No | Bitrix filter object. Keys may carry operator prefixes: '>', '<', '>=', '<=', '!', '%' (substring), '=%', e.g. {">=DATE_CREATE": "2026-01-01", "%TITLE": "draft"}. | |
| select | No | Fields to return, e.g. ['ID','TITLE','*','UF_*']. Omit for defaults. | |
| fetch_all | No | Auto-paginate and return all matching records (capped by BITRIX_MAX_PAGES, default 40 pages = 2000 records). Use a filter to keep this bounded. | |
| iblock_id | Yes | Information-block id of the list (numeric IBLOCK_ID). | |
| webhook_url | No | Override the default incoming webhook for this call (https://<portal>/rest/<user_id>/<token>/). If omitted, uses personal_webhook, then the X-B24-Webhook HTTP header, then the BITRIX_WEBHOOK_URL env default. | |
| iblock_type_id | Yes | Information-block type, e.g. 'lists' (portal lists), 'bitrix_processes' (workflows), 'lists_socnet' (group lists). | |
| personal_webhook | No | Act as a specific user (their personal incoming webhook). Takes precedence over webhook_url. Required to write to the portal under that user's permissions. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |