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
| Key | Datatype | Required | Description |
|---|---|---|---|
fields[event] | string | For more information please visit https://developers.klaviyo.com/en/v2024-02-15/reference/api-overview#sparse-fieldsets | |
fields[metric] | string | For more information please visit https://developers.klaviyo.com/en/v2024-02-15/reference/api-overview#sparse-fieldsets | |
fields[profile] | string | For more information please visit https://developers.klaviyo.com/en/v2024-02-15/reference/api-overview#sparse-fieldsets | |
filter | string | For more information please visit https://developers.klaviyo.com/en/v2024-02-15/reference/api-overview#filtering<br>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 | |
include | string | For more information please visit https://developers.klaviyo.com/en/v2024-02-15/reference/api-overview#relationships | |
page[cursor] | string | For more information please visit https://developers.klaviyo.com/en/v2024-02-15/reference/api-overview#pagination | |
sort | string | For more information please visit https://developers.klaviyo.com/en/v2024-02-15/reference/api-overview#sorting |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
revision | string | (Required) API endpoint revision (format: YYYY-MM-DD[.suffix]) | |
Accept | string |
RESPONSES
status: OK
{"data":[{"type":"event","id":"\u003cstring\u003e","attributes":{"timestamp":"\u003cinteger\u003e","event_properties":{},"datetime":"\u003cdateTime\u003e","uuid":"\u003cstring\u003e"},"links":{"self":"\u003curi\u003e"},"relationships":{"profile":{"data":{"type":"profile","id":"\u003cstring\u003e"},"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}},"metric":{"data":{"type":"metric","id":"\u003cstring\u003e"},"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}},"attributions":{"data":[{"type":"attribution","id":"\u003cstring\u003e"},{"type":"attribution","id":"\u003cstring\u003e"}],"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}}}},{"type":"event","id":"\u003cstring\u003e","attributes":{"timestamp":"\u003cinteger\u003e","event_properties":{},"datetime":"\u003cdateTime\u003e","uuid":"\u003cstring\u003e"},"links":{"self":"\u003curi\u003e"},"relationships":{"profile":{"data":{"type":"profile","id":"\u003cstring\u003e"},"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}},"metric":{"data":{"type":"metric","id":"\u003cstring\u003e"},"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}},"attributions":{"data":[{"type":"attribution","id":"\u003cstring\u003e"},{"type":"attribution","id":"\u003cstring\u003e"}],"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}}}}],"links":{"self":"\u003curi\u003e","first":"\u003curi\u003e","last":"\u003curi\u003e","prev":"\u003curi\u003e","next":"\u003curi\u003e"},"included":[{"type":"attribution","id":"\u003cstring\u003e","links":{"self":"\u003curi\u003e"},"relationships":{"event":{"data":{"type":"event","id":"\u003cstring\u003e"}},"attributed-event":{"data":{"type":"event","id":"\u003cstring\u003e"}},"campaign":{"data":{"type":"campaign","id":"\u003cstring\u003e"}},"campaign-message":{"data":{"type":"campaign-message","id":"\u003cstring\u003e"}},"flow":{"data":{"type":"flow","id":"\u003cstring\u003e"}},"flow-message":{"data":{"type":"flow-message","id":"\u003cstring\u003e"}},"flow-message-variation":{"data":{"type":"flow-message","id":"\u003cstring\u003e"}}}},{"type":"attribution","id":"\u003cstring\u003e","links":{"self":"\u003curi\u003e"},"relationships":{"event":{"data":{"type":"event","id":"\u003cstring\u003e"}},"attributed-event":{"data":{"type":"event","id":"\u003cstring\u003e"}},"campaign":{"data":{"type":"campaign","id":"\u003cstring\u003e"}},"campaign-message":{"data":{"type":"campaign-message","id":"\u003cstring\u003e"}},"flow":{"data":{"type":"flow","id":"\u003cstring\u003e"}},"flow-message":{"data":{"type":"flow-message","id":"\u003cstring\u003e"}},"flow-message-variation":{"data":{"type":"flow-message","id":"\u003cstring\u003e"}}}}]}