GET /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

OpenAPI Spec

Servers

https://a.klaviyo.com

Request headers

Name Type Required Description

Name	Type	Required	Description
`revision`	String	Yes	API endpoint revision (format: YYYY-MM-DD[.suffix]) Default value: "2026-04-15"

revision

String

Yes

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

Default value: "2026-04-15"

Query parameters

Name	Type	Required	Description
`fields[event][]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
`page[cursor]`	String	No	For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
`include[]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
`filter`	String	No	For more information please visit https://developers.klaviyo.com/en/v2026-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`
`sort`	String	No	For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting Valid values: `"-timestamp"` `"timestamp"` `"-datetime"` `"datetime"`
`page[size]`	Integer	No	Default: 200. Min: 1. Max: 1000. Default value: 200
`fields[profile][]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
`fields[attribution][]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
`fields[metric][]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.