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
| Key | Datatype | Required | Description |
|---|---|---|---|
since | null | Either 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. | |
count | number | Number of events to return in a batch. Default = 50, Max = 100 | |
sort | string | Sort 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
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
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"}