API Reference / List leads
List leads
GET/api/v1/leads
Leads newest first with status, score and primary contact, paged by an opaque cursor. Never draft bodies.
curl -H "Authorization: Bearer $REVNU_API_TOKEN" "https://revnu.com/api/v1/leads?status=replied&limit=50"Query
| Param | Meaning |
|---|---|
status |
Filter by lead status. |
limit |
1 to 100. |
cursor |
The nextCursor from the previous page. |
Response
{ "leads": [lead, …], "nextCursor": "…" | null }. A page is bounded in rows and in bytes, so pass nextCursor back until it is null.
Agents: this page is also markdown at /docs/leads.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.
Frequently Asked Questions
`leads:read`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.