HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference
ChangelogHelp CenterCommunityContact Us
Start typing to search…

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/v2025-04-15/reference/api-overview#sparse-fieldsets

fields[event]
fields[metric]
array of strings

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

fields[metric]
fields[profile]
array of strings

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

fields[profile]
string

For more information please visit https://developers.klaviyo.com/en/v2025-04-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/v2025-04-15/reference/api-overview#relationships

include
string

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

string

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

Headers
string
required
Defaults to 2025-04-15

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

Responses

Updated 6 days ago

Did this page help you?
Language
Credentials

Updated 6 days ago

Did this page help you?
Power smarter
digital relationships
By entering your information and clicking “Sign up,” you consent to receive marketing emails (such as newsletters, blog posts, webinars, event invitations and new product updates) from Klaviyo from time to time. You can unsubscribe at any time by clicking on the “Unsubscribe” link at the bottom of our emails. For more information on how we process your personal information and what rights you have in this respect, please see our Privacy Policy.
Terms and Privacy Trademarks Security