list_leads
Search and list amoCRM deals using filters like pipeline, status, responsible user, and date ranges. Supports sorting and compact view for readable results.
Instructions
Search and list deals (leads) in amoCRM. Filters: pipeline, statuses, responsible users, created/updated/closed date ranges, full-text search. Supports sorting. Set compact=true for a trimmed, readable list. For counts and breakdowns use leads_summary instead of paging through leads.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_leads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Fetch specific lead IDs | |
| page | No | Page number (default 1) | |
| with | No | Related entities to embed in response | |
| limit | No | Items per page (max 250, default 50) | |
| query | No | Search query across lead name, contacts, companies | |
| compact | No | Return a trimmed view: readable dates, custom fields as name→value, no cookies/tracking noise. Recommended for lists. | |
| order_by | No | Sort field (API default: oldest first) | |
| statuses | No | Filter by statuses: array of {pipeline_id, status_id} | |
| closed_to | No | Closed at or before this date | |
| order_dir | No | Sort direction (default desc when order_by is set) | |
| created_to | No | Created at or before this date | |
| updated_to | No | Updated at or before this date | |
| closed_from | No | Closed at or after this date | |
| pipeline_id | No | Filter by pipeline ID | |
| created_from | No | Created at or after this date | |
| updated_from | No | Updated at or after this date | |
| responsible_user_ids | No | Filter by responsible user IDs (see list_users) |