Get Events

GET {{baseUrl}}/api/events/

Get all events in an account

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

Returns a maximum of 200 events per page.

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

Scopes: events:read

Request Params

KeyDatatypeRequiredDescription
fields[event]stringFor more information please visit https://developers.klaviyo.com/en/v2024-06-15/reference/api-overview#sparse-fieldsets
fields[metric]stringFor more information please visit https://developers.klaviyo.com/en/v2024-06-15/reference/api-overview#sparse-fieldsets
fields[profile]stringFor more information please visit https://developers.klaviyo.com/en/v2024-06-15/reference/api-overview#sparse-fieldsets
filterstringFor more information please visit https://developers.klaviyo.com/en/v2024-06-15/reference/api-overview#filtering&lt;br&gt;Allowed field(s)/operator(s):<br>metric_id: equals<br>profile_id: equals<br>profile: has<br>datetime: greater-or-equal, greater-than, less-or-equal, less-than<br>timestamp: greater-or-equal, greater-than, less-or-equal, less-than
includestringFor more information please visit https://developers.klaviyo.com/en/v2024-06-15/reference/api-overview#relationships
page[cursor]stringFor more information please visit https://developers.klaviyo.com/en/v2024-06-15/reference/api-overview#pagination
sortstringFor more information please visit https://developers.klaviyo.com/en/v2024-06-15/reference/api-overview#sorting

HEADERS

KeyDatatypeRequiredDescription
revisionstring(Required) API endpoint revision (format: YYYY-MM-DD[.suffix])
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;type&quot;:&quot;event&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;attributes&quot;:{&quot;timestamp&quot;:&quot;\u003cinteger\u003e&quot;,&quot;event_properties&quot;:{},&quot;datetime&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;uuid&quot;:&quot;\u003cstring\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;},&quot;relationships&quot;:{&quot;profile&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;profile&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}},&quot;metric&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;metric&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}},&quot;attributions&quot;:{&quot;data&quot;:[{&quot;type&quot;:&quot;attribution&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},{&quot;type&quot;:&quot;attribution&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}],&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}}}},{&quot;type&quot;:&quot;event&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;attributes&quot;:{&quot;timestamp&quot;:&quot;\u003cinteger\u003e&quot;,&quot;event_properties&quot;:{},&quot;datetime&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;uuid&quot;:&quot;\u003cstring\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;},&quot;relationships&quot;:{&quot;profile&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;profile&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}},&quot;metric&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;metric&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}},&quot;attributions&quot;:{&quot;data&quot;:[{&quot;type&quot;:&quot;attribution&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},{&quot;type&quot;:&quot;attribution&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}],&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}}}}],&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;first&quot;:&quot;\u003curi\u003e&quot;,&quot;last&quot;:&quot;\u003curi\u003e&quot;,&quot;prev&quot;:&quot;\u003curi\u003e&quot;,&quot;next&quot;:&quot;\u003curi\u003e&quot;},&quot;included&quot;:[{&quot;type&quot;:&quot;attribution&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;},&quot;relationships&quot;:{&quot;event&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;event&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;attributed-event&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;event&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;campaign&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;campaign&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;campaign-message&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;campaign-message&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;flow&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;flow&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;flow-message&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;flow-message&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;flow-message-variation&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;flow-message&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}}}},{&quot;type&quot;:&quot;attribution&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;},&quot;relationships&quot;:{&quot;event&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;event&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;attributed-event&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;event&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;campaign&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;campaign&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;campaign-message&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;campaign-message&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;flow&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;flow&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;flow-message&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;flow-message&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}},&quot;flow-message-variation&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;flow-message&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}}}}]}