List Events

Retrieve a list of events. Please note that due to our data retention policy,
only events from the last 2 years are available.

Requires api token with one of the following permissions

Read detailed stats

Tokens with the "Act with a team member's permissions" permission
(all:delegate_to_contact_permissions scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An expiring access token
created with the all:delegate_to_contact_permissions scope and an
account authorization granting the view-stats permission can also
be used.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

An optional identifier for a specific video.

string

An optional identifier for a specific visitor.

integer

Maximum number of events to retrieve (capped at 100).

integer

The page of events to get data from.

date

Start date in the format 'YYYY-MM-DD'.

date

End date in the format 'YYYY-MM-DD'.

Headers
string
required
Defaults to 2026-09
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json