Get Events

GET {{baseUrl}}/api/events/

Get all events in an account Requests can be sorted by the following fields: datetime, timestamp Use filters to narrow your results to specific metrics. Request specific fields using sparse fieldsets. Include parameters can be provided to get the following related resource data: metrics, profiles Returns a maximum of 200 events per page, which can be paginated with cursor-based pagination.

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/v2022-10-17/reference/api-overview#sparse-fieldsets
fields[metric]stringFor more information please visit https://developers.klaviyo.com/en/v2022-10-17/reference/api-overview#sparse-fieldsets
fields[profile]stringFor more information please visit https://developers.klaviyo.com/en/v2022-10-17/reference/api-overview#sparse-fieldsets
filterstringFor more information please visit https://developers.klaviyo.com/en/v2022-10-17/reference/api-overview#filtering&lt;br&gt;Allowed field(s)/operator(s):<br>metric_id: equals<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/v2022-10-17/reference/api-overview#relationships
includestringFor more information please visit https://developers.klaviyo.com/en/v2022-10-17/reference/api-overview#relationships
page[cursor]stringFor more information please visit https://developers.klaviyo.com/en/v2022-10-17/reference/api-overview#pagination
sortstringFor more information please visit https://developers.klaviyo.com/en/v2022-10-17/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;enim deserunt ex Excepteur nostrud&quot;,&quot;attributes&quot;:{&quot;metric_id&quot;:&quot;reprehenderit aliquip esse elit officia&quot;,&quot;profile_id&quot;:&quot;veniam est pariatur ea&quot;,&quot;timestamp&quot;:&quot;anim adipisicing ex occaecat&quot;,&quot;event_properties&quot;:{},&quot;datetime&quot;:&quot;sit amet aliqua consectetur&quot;,&quot;uuid&quot;:&quot;incididunt velit aute&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;http://znvgQDXUpNTGoICoonzDyKgCYtvB.hbpsN0q3PPoR.0,+P4riN3PNBEQ6rd,z2yrHcJ0,ppurQykrhEmCEq&quot;},&quot;relationships&quot;:{&quot;metrics&quot;:{&quot;data&quot;:[{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}]},&quot;profiles&quot;:{&quot;data&quot;:[{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}]}},&quot;included&quot;:[{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;attributes&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;links&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;attributes&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;links&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}]},{&quot;type&quot;:&quot;event&quot;,&quot;id&quot;:&quot;Excepteur id anim&quot;,&quot;attributes&quot;:{&quot;metric_id&quot;:&quot;sint minim ex&quot;,&quot;profile_id&quot;:&quot;fugiat ut&quot;,&quot;timestamp&quot;:&quot;aliqua amet do&quot;,&quot;event_properties&quot;:{},&quot;datetime&quot;:&quot;proident dolore anim dolore&quot;,&quot;uuid&quot;:&quot;enim commodo voluptate esse sunt&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;https://vhbTAsBdqslj.quCj3WvhFDMe8Pb.x.7DJz0FVbTbZoZEjTS&quot;},&quot;relationships&quot;:{&quot;metrics&quot;:{&quot;data&quot;:[{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}]},&quot;profiles&quot;:{&quot;data&quot;:[{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}]}},&quot;included&quot;:[{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;attributes&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;links&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;type&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;attributes&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;links&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}]}],&quot;links&quot;:{&quot;self&quot;:&quot;https://XhYpomZzciQcJtq.hpoeQfjbF,FCwfzn9UF-Hg5nGcl88.Xw&quot;,&quot;first&quot;:&quot;https://fQpJArUKOYYQAnhyKRHmQoDrxccfTkCI.pgszQaEUIyO.V&quot;,&quot;last&quot;:&quot;https://MBXhyWNFaurTLWTMyzvMBQyyhxFokOq.cqwic9ZPohfgd62gHIRYYJ,UTNRe.KCvMOLN&quot;,&quot;prev&quot;:&quot;https://JDL.dicH.0pRh&quot;,&quot;next&quot;:&quot;http://Rqht.vifhDkufrIgGhKZX3JNOH7z2oieJmdP,6oaE1&quot;}}