HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference
ChangelogHelp CenterCommunityContact Us

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 200 events per page by default, and up to 1000 with page[size].

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

Scopes:
events:read

OpenAPI Spec

Query Params
fields[attribution]
array of strings

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

fields[attribution]
Allowed:
fields[event]
array of strings

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

fields[event]
Allowed:
fields[metric]
array of strings

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

fields[metric]
Allowed:
fields[profile]
array of strings

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

fields[profile]
string

For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
metric_id: equals (string)
profile_id: equals (string)
profile: has
metric: has
properties.<key>: equals
datetime: greater-or-equal, greater-than, less-or-equal, less-than (date-time)
timestamp: greater-or-equal, greater-than, less-or-equal, less-than (number)

include
array of strings

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

include
Allowed:
string

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

integer
1 to 1000
Defaults to 200

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

string
enum

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

Allowed:
Headers
string
required
Defaults to 2026-10-15

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

Responses

Updated 6 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json

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