Skip to main content
GET
List leads
This endpoint allows you to list all leads belonging to the authenticated user with various filtering and pagination options.

Query Parameters

string
Filter leads by status. Possible values: created, scheduled, processing, completed, rescheduled, reached-max-retries, blacklisted
integer
Filter leads by campaign ID
string
Filter leads by phone number (partial match supported)
string
Filter leads created from this date (YYYY-MM-DD format)
string
Filter leads created until this date (YYYY-MM-DD format)
integer
Number of leads per page (1-100, default: 15)
integer
Page number (default: 1)

Response fields

array
integer
The current page number
integer
Number of items per page
integer
Total number of leads matching the criteria
integer
The last page number