# List events by contact

**GET** `/contacts/{contactId}/events`

Returns the timeline of events recorded for a contact.

Authentication: bearerAuth
Required scopes: `event:list`
Allowed roles: `owner`, `admin`, `agent`
Authorization: List events for a contact.

## Parameters

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

## Responses

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