Get Leads
get_leadsGet Leads in a List - Retrieve all leads/contacts in a specific list. Supported filters: search, archived, sort, sequence, status.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"list_id": "<list_id>"
},
"name": "get_leads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| skip | No | Number of leads to skip for pagination | |
| sort | No | Sort order by creation date | |
| limit | No | Maximum number of leads to return (max 100) | |
| search | No | Search query to filter leads by name/email | |
| status | No | Filter by lead status (not_contacted, contacted, opened, clicked, replied, bounced, unsubscribed). Works with or without `sequence`; without it, the status matches across all sequences (e.g. replied = replied in any sequence). Omit to return the full list. | |
| list_id | Yes | The list ID to get leads from | |
| archived | No | Filter by archived status (truthy only; false is unreliable) | |
| sequence | No | Filter by sequence ID | |
| workspace_id | No | Workspace ID this action applies to. When omitted, the current or default workspace is used. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | The raw result returned by the SalesBlink tool. |