Skip to main content
GET
List leads
Retrieve a paginated list of leads for your organization. Use Cases:
  • Display leads in external CRM dashboards
  • Track lead attribution for commission platforms
  • Export lead data for analytics
Filtering:
  • Filter by status, created date, recent activity (active_from, the board’s date filter), or pipeline stage
  • Use stage for leads who have not booked yet (interested, qualified, disqualified). /v1/opportunities lists booking calls, so it cannot show them.
  • Results are automatically scoped to your organization
Pagination:
  • Cursor-based pagination (use cursor from previous response)
  • Default limit: 50, max: 100

Query Parameters

limit
integer

Number of results per page (1-100, values outside clamp)

Example:

50

cursor
string

Cursor for pagination (opaque string)

Example:

"eyJpZCI6IjEyMyJ9"

status
string

Filter by lead status

Example:

"new"

stage
enum<string>

Keep leads in one derived pipeline stage, the column the lead sits in on the Aura pipeline board. Use this for interested, qualified and disqualified: those leads usually have not booked a call, so /v1/opportunities, which lists booking calls, has almost none of them. Leads an admin deleted are left out, as on the board, and so are leads archived through this API, which the board still shows. The stage is not stored, so the server searches up to 1,000 leads newest first to fill the page. A page can be short or empty while has_more is true; keep paging with next_cursor.

Available options:
interested,
disqualified,
qualified,
booked,
confirmed,
declined,
cancelled,
attended,
unfit,
no_show,
follow_up,
lost,
won
Example:

"qualified"

created_from
string

Keep leads created on or after this date: an ISO 8601 date (read as UTC) or a timestamp with a zone.

Example:

"2026-01-01"

created_to
string

Keep leads created on or before this date. A date with no time includes that whole day.

Example:

"2026-01-31"

active_from
string

Keep leads created, or with any form fill or call, on or after this date. The pipeline board's date filter: a returning lead who filled a form this week is included though it was created earlier.

Example:

"2026-01-01"

active_to
string

Keep leads created, or with any form fill or call, on or before this date. A date with no time includes that whole day.

Example:

"2026-01-31"

Response

Successfully retrieved leads

data
object[]
required

Array of leads

pagination
object
required
filters
object

The filters the server applied, as resolved values. Check it when a page is empty to tell no matches from a filter you did not mean.