Get Profile's Events for all Metrics

GET {{baseUrl}}/v1/person/:person_id/metrics/timeline?since=&count=50&sort=desc

Returns a batched timeline of all events for a person.

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. Default = 50, Max = 100
sortstringSort order to apply to timeline, either descending or ascending. Valid values are desc or asc. Defaults to desc. Always descending when since is not sent, as since defaults to current time.

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"}