Get Profile's Events for a Specific Metric

GET {{baseUrl}}/v1/person/:person_id/metric/:metric_id/timeline?since=&count=100&sort=desc

Returns a person's batched timeline for one specific event type.

Request Params

KeyDatatypeRequiredDescription
sincenullEither a 10-digit Unix timestamp (UTC) to use as starting datetime, OR a pagination token obtained from the next attribute of a prior API call. For backwards compatibility, UUIDs will continue to be supported for a limited time. Defaults to current time.
countnumberNumber of events to return in a batch.
sortstringSort order to apply to timeline, either descending or ascending. Valid values are desc or asc. Defaults to desc.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"object":"$list","count":1,"data":[{"object":"event","statistic_id":"STATISTIC_ID","timestamp":1234567890,"event_name":"Placed Order","event_properties":{"$value":100,"items":[{"name":"Boots","sku":"ITEM_SKU","price":50,"quantity":2}]},"datetime":"2021-11-23 11:21:01+00:00","uuid":"UNIQUE_EVENT_ID","person":{"object":"person","$email":"george.washington@klaviyo.com"}}],"next":"1400656845-ABCDEFG"}