Get Events

get

https://a.klaviyo.com/api/events

Get all events in an account

Requests can be sorted by the following fields:
datetime, timestamp

Custom metrics are not supported in the metric_id filter.

Returns a maximum of 200 events per page.

Rate limits:
Burst: 350/s
Steady: 3500/m

Scopes:
events:read

Query Params

fields[event]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#sparse-fieldsets

fields[event]

fields[metric]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#sparse-fieldsets

fields[metric]

fields[profile]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#sparse-fieldsets

fields[profile]

filter

string

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
metric_id: equals
profile_id: equals
profile: has
datetime: greater-or-equal, greater-than, less-or-equal, less-than
timestamp: greater-or-equal, greater-than, less-or-equal, less-than

include

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#relationships

include

page[cursor]

string

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#pagination

page[size]

integer

1 to 1000

Defaults to 200

Default: 200. Min: 1. Max: 1000.

sort

string

enum

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#sorting

Allowed:

Headers

revision

string

required

Defaults to 2026-01-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

200Success

4XXClient Error

5XXServer Error