# List events

**GET** `/events`

Returns recorded customer events, optionally filtered by event type.

Authentication: bearerAuth
Required scopes: `event:list`
Allowed roles: `owner`, `admin`, `agent`
Authorization: List events in the workspace.

## Parameters

- `pageSize` (query integer, optional)
- `pageToken` (query string, optional)
- `eventTypeId` (query string, optional)

## Responses

- `200`: List of events
- `default`: Error