Get Events

GET {{baseUrl}}/api/events/

Get all events in an account Requests can be sorted by the following fields: datetime, timestamp Include parameters can be provided to get the following related resource data: metrics, profiles 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/v2023-01-24/reference/api-overview#sparse-fieldsets
fields[metric]stringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#sparse-fieldsets
fields[profile]stringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#sparse-fieldsets
filterstringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/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/v2023-01-24/reference/api-overview#relationships
includestringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#relationships
page[cursor]stringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#pagination
sortstringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/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;fugiat veniam ut eu&quot;,&quot;attributes&quot;:{&quot;metric_id&quot;:&quot;quis velit elit id&quot;,&quot;profile_id&quot;:&quot;D&quot;,&quot;timestamp&quot;:&quot;aute ea Ut&quot;,&quot;event_properties&quot;:{},&quot;datetime&quot;:&quot;est laboris dolor irure consectetur&quot;,&quot;uuid&quot;:&quot;amet&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;http://KBxwgelmmgQRpjq.bgumWW0U24jtS0KNP+6K&quot;},&quot;relationships&quot;:{&quot;metrics&quot;:{&quot;data&quot;:[{&quot;type&quot;:&quot;metric&quot;,&quot;id&quot;:&quot;mo&quot;},{&quot;type&quot;:&quot;metric&quot;,&quot;id&quot;:&quot;sit ex velit ullamco sunt&quot;}]},&quot;profiles&quot;:{&quot;data&quot;:[{&quot;type&quot;:&quot;profile&quot;,&quot;id&quot;:&quot;est eiusmod ipsum&quot;},{&quot;type&quot;:&quot;profile&quot;,&quot;id&quot;:&quot;Excepteur sit&quot;}]}}},{&quot;type&quot;:&quot;event&quot;,&quot;id&quot;:&quot;labore ex&quot;,&quot;attributes&quot;:{&quot;metric_id&quot;:&quot;culpa Excepteur&quot;,&quot;profile_id&quot;:&quot;anim pariatur&quot;,&quot;timestamp&quot;:&quot;non minim laboris Duis nisi&quot;,&quot;event_properties&quot;:{},&quot;datetime&quot;:&quot;anim elit&quot;,&quot;uuid&quot;:&quot;el&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;http://AtDpsMlfZEthAtinnz.zkYHF2kdOdps3ngnvsgc8qL0lvyaSGvUdDMou,qRjzn&quot;},&quot;relationships&quot;:{&quot;metrics&quot;:{&quot;data&quot;:[{&quot;type&quot;:&quot;metric&quot;,&quot;id&quot;:&quot;voluptate Lorem&quot;},{&quot;type&quot;:&quot;metric&quot;,&quot;id&quot;:&quot;occaecat aliquip Excepteur&quot;}]},&quot;profiles&quot;:{&quot;data&quot;:[{&quot;type&quot;:&quot;profile&quot;,&quot;id&quot;:&quot;ut commodo sunt&quot;},{&quot;type&quot;:&quot;profile&quot;,&quot;id&quot;:&quot;aliquip id ea dolore&quot;}]}}}],&quot;links&quot;:{&quot;self&quot;:&quot;http://rqIWMFrrZ.rnsmIKD3&quot;,&quot;first&quot;:&quot;https://GwA.vll,-oq6.M&quot;,&quot;last&quot;:&quot;http://bMCfP.uwquauny4R13vPVoIgmB2Fy7JUArs+CZbnD&quot;,&quot;prev&quot;:&quot;https://XEZQFpCaGJNVhomjyopXjcovyeIb.pvegwbHaZF2X,40&quot;,&quot;next&quot;:&quot;http://FfK.jhIDxoSHkHcdyyO&quot;},&quot;included&quot;:[{&quot;type&quot;:&quot;metric&quot;,&quot;id&quot;:&quot;incididunt eiusmod ut deserunt&quot;,&quot;attributes&quot;:{&quot;name&quot;:&quot;sunt elit&quot;,&quot;created&quot;:&quot;fugiat magna occaecat&quot;,&quot;updated&quot;:&quot;cupidatat consectetur consequat&quot;,&quot;integration&quot;:{}},&quot;links&quot;:{&quot;self&quot;:&quot;https://njofdbYDHVYAss.rkhujy7A3sJo&quot;}},{&quot;type&quot;:&quot;metric&quot;,&quot;id&quot;:&quot;aliquip deserunt Duis&quot;,&quot;attributes&quot;:{&quot;name&quot;:&quot;eu&quot;,&quot;created&quot;:&quot;sed eiusmod aute anim&quot;,&quot;updated&quot;:&quot;aute ut in&quot;,&quot;integration&quot;:{}},&quot;links&quot;:{&quot;self&quot;:&quot;http://xfAhzRVsaNOOg.puk1H.pXCRxIXhjBsaYfDmOmx9&quot;}}]}