Skip to main content
Returns a paginated list of all leads belonging to the authenticated user. Filter by campaign, status, phone number, or date range.

Endpoint

GET /user/leads

Query parameters

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

Response

array
Array of lead objects.
integer
Current page number.
integer
Items per page.
integer
Total matching leads.
integer
Last page number.

Example

200 Response