List leads (single team)
The canonical leads feed for one team: the historical/pull counterpart to the lead.* event webhooks, including the raw third-party payload. Keyset cursor-paginated ascending by (created_at, id). Leads from registered test phone numbers are excluded by default (include_test_numbers=true opts in). Requires the read:leads permission.
Authorizations
API key in the format avoca_<64 hex characters>
Path Parameters
The team ID
Query Parameters
Inclusive lower bound on created_at (>=)
Exclusive upper bound on created_at (<)
Lead-source medium
webhook, email_alerts, st_bookings_alerts, st_native, google_lsa, yelp, web_chat, dropped_responder Lead-source canonical name (exact match)
Lead processing status
created, queued, processing, completed, failed, skipped When false, omit the raw third-party payload field (default true)
When true, include suppressed leads (adds is_ignored / ignored_reason)
When true, include leads from the team's registered test phone numbers (default false)
Opaque pagination cursor from the previous response's pagination.cursor
Results per page (default 50, max 500)
x <= 500