leads.list
List leads and prospects. Returns name, phone, email, service type, status, priority, source, and timestamps. Supports filtering and cursor-based pagination. Tip: Use leads.create to add new leads, then leads.list to verify.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of leads to return. Defaults to 50, capped at 100. | |
| cursor | No | Pagination cursor from previous response. Pass to get next page of results. | |
| status | No | Filter by lead pipeline stage. Omit to return all statuses. | |
| priority | No | Filter by priority level. Omit to return all priorities. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Total number of leads returned | |
| leads | No | List of lead records | |
| next_cursor | No | Cursor for next page. Null if no more results. |