Visitor Timeline
Get the chronological event timeline for a specific visitor.
Visitor Timeline
Returns a chronological feed of events for a specific visitor, including pageviews, goal completions, and purchases.
Endpoint
GET /api/v1/organizations/:orgId/sites/:siteId/visitors/:visitorId/timeline
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
visitorId | string | Yes | The visitor ID |
Response fields
Returns the visitor profile and a timeline array. The response includes pagination fields total, page, and limit.
Each timeline entry:
| Field | Type | Description |
|---|---|---|
id | string | Event ID |
session_id | string | Session ID |
event_type | string | Event type (pageview, goal, purchase, form) |
timestamp | string | ISO 8601 event timestamp |
page_url | string | Page URL (for pageviews) |
page_title | string | Page title (for pageviews) |
event_name | string | Event/goal name (for goal events) |
revenue | number | Revenue amount (for purchase events) |
currency | string | Revenue currency code |
referrer_source | string | Referrer source for this event |
properties | object | Custom event properties |