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

Servers

Request headers

Name Type Required Description
revision String Yes

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

Default value: "2025-04-15"

Query parameters

Name Type Required Description
include[] Array No

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

filter String No

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

fieldsevent[] Array No

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

sort String No

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

Possible values:

  • "-timestamp"
  • "timestamp"
  • "-datetime"
  • "datetime"
fieldsmetric[] Array No

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

fieldsprofile[] Array No

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

pagecursor String No

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

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.