# List leads

> Leads newest first with status, score and primary contact, paged by an opaque cursor. Never draft bodies.

Canonical: https://revnu.com/docs/leads

```bash
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.

## Frequently asked questions

### Which scope does this need?

`leads:read`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.

### Are responses cached?

No. Every response is `Cache-Control: no-store`, so what you read is current.