# List leads

### List leads

`GET /api/v1/leads`

Operation ID: `listLeads`

**Query parameters**

- `cursor` (string, optional)
- `limit` (integer, optional)

**200**: A page of leads in this organization, newest first. Pass nextCursor as cursor for the next page.

- `leads` (object[], required)
- `nextCursor` (string | null, required)

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload