# List lead events

### List lead events

`GET /api/v1/leads/{leadId}/events`

Operation ID: `listLeadEvents`

**Path parameters**

- `leadId` (string · uuid, required): Lead id

**Query parameters**

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

**200**: A page of events for this lead, newest first. Pass nextCursor as cursor for the next page.

- `events` (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