Query Event Data

GET {{baseUrl}}/v1/metric/:metric_id/export?start_date=&end_date=&unit=day&measurement=count&where=[["$attributed_flow","=","FLOW_ID"]]&by=$attributed_flow&count=25

Exports event data from Klaviyo, optionally filtering and segmenting on available event properties. Note that the only comparison operator currently supported is =. To ensure a correct response, enter parameters in the curl request as they are ordered below:

Request Params

KeyDatatypeRequiredDescription
start_datenull
Beginning of timeframe to pull event data for. The default value is 1 month ago. Can also accept a 10-digit UNIX timestamp. When sending a start_date, you must also send an end_date

Ex: 1610524800 OR 2021-01-13 | | end_date | null | | End of timeframe to pull event data for. The default is the current day, or 1 month from start_date, whichever is sooner. Can also accept a 10-digit UNIX timestamp. When sending an end_date, you must also send a start_date. Must be at most 31 days after start_date

Ex: 1612080000 OR 2021-01-31 | | unit | string | | Granularity to bucket data points into - one of day, week, or month. Defaults to day. | | measurement | string | | Type of metric to fetch - one of unique, count, value, or sum. Defaults to count. For sum a property name to operate on must be supplied as a JSON-encoded list like ["sum","ItemCount"] | | where | string | | Optional, JSON-encoded list. Conditions to use to filter the set of events. A max of 1 condition can be given. where and by parameters cannot be specified at the same time.

ex: [["$attributed_flow","=","FLOW_ID"]] | | by | string | | The name of a property to segment the event data on. where and by parameters cannot be specified at the same time. Cannot be used alongside where parameter. | | count | number | | Maximum number of segments to return. Default = 25, MAX = 1000 |

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"metric":{"object":"metric","name":"Placed Order","integration":{"category":"eCommerce","object":"integration","name":"Shopify"},"created":"2015-02-12 18:02:34","updated":"2015-02-12 18:51:41"},"start_date":"2015-01-01 00:00:00","end_date":"2015-01-31 00:00:00","unit":"weekly","measurement":"c","by":"","where":"","results":[{"segment":"Everyone","data":[{"date":"2015-01-13 00:00:00","values":[5]},{"date":"2015-01-14 00:00:00","values":[5]}]}]}