List leads
Leads in the organization, newest first, a page at a time. Filter by stage, source, owner, time of last change, or any field. Archived leads are left out.
Scope: leads.read.
Authorizations
An organization API key, created in Settings → Connections → API keys. Keys start with mk_live_. Marro stores only a hash of a key, so it is shown once, when it is created: copy it then. Revoking a key ends its access at once. To replace a key without downtime, create the new one, switch your server to it, then revoke the old one. Changes made with a key appear on the lead’s timeline as made by the person who created the key, via the API. Scopes: leads.read (Read leads), leads.write (Create and update leads), leads.capture (Capture leads).
Query Parameters
How many leads to return, 1–100.
1 <= x <= 100The nextCursor from the previous page.
x <= 2147483647Only leads changed at or after this time, for syncing.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$Only leads in this stage (IDs from GET /api/v1/lead-stages).
x <= 2147483647Only leads in this pipeline (IDs from GET /api/v1/pipelines).
x <= 2147483647Only leads from this source (IDs from GET /api/v1/lead-sources).
x <= 2147483647Only leads owned by this person (IDs from GET /api/v1/users).
x <= 2147483647A JSON array of field filters: [{"field":"city","operator":"contains","value":"Hyd"}]. All filters must match. The operators each field type takes are in this parameter’s x-filter-operators.
8000