bitrix24_crm_lead_list
List and filter CRM leads by status, assignee, creation date, and more. Sort results and select specific fields to return.
Instructions
List and filter CRM leads
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max leads to return. WITHOUT this the tool returns at most 500 (10 pages x 50) and silently truncates — the response 'total' shows the true match count while 'leads' is capped at 500. For a query that matches more, pass limit >= total to fetch everything. | |
| order | No | Sort order, e.g. {ID: 'desc'} | |
| filter | No | Filter, e.g. {STATUS_ID: 'NEW', ASSIGNED_BY_ID: 854}. Comparison operators DO work here, re-verified against this portal 2026-07-28: {'>=DATE_CREATE': '2026-07-20T00:00:00+03:00'} (inclusive, full ISO timestamp honoured), {'>DATE_CREATE': ...} (exclusive), {'>=ID': N} and {'>ID': N} all filter correctly — this tool posts the filter as JSON, so the curl --data-urlencode trap (which leaves the '>' in the KEY unencoded and makes Bitrix drop the condition) does not apply. Date-only values with a strict '>' are NOT required. The operator that IS unreliable: {FIELD: ''} ("is empty") on UF string fields returns records regardless (measured: 8 of 50 rows came back non-empty), so always client-check the value. {'!FIELD': ''} (truthy) and {FIELD: value} (exact) are reliable. | |
| select | No | Fields to return |