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
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. | |
sort | string | Sort order to apply to timeline, either descending or ascending. Valid values are desc or asc . Defaults to desc . |
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"}