Visitor journey

curl "https://app.trackrev.io/api/v1/visitors/<visitor-id>/journey" \
  -H "Authorization: Bearer <your secret key>"

{
  "visitor": {
    "id": "v3b4...",
    "email": "customer@example.com",
    "first_seen": "2026-07-01T12:00:00.000Z",
    "last_seen": "2026-07-21T09:20:00.000Z"
  },
  "journey": [
    { "type": "click", "ts": "2026-07-01T12:00:00.000Z", "channel": "newsletter", "slug": "spring" },
    { "type": "identify", "ts": "2026-07-03T08:30:00.000Z", "email": "customer@example.com" },
    { "type": "order", "ts": "2026-07-05T15:45:00.000Z", "amount": 90.0, "currency": "usd" }
  ]
}

curl "https://app.trackrev.io/api/v1/visitors/<visitor-id>/journey" \
  -H "Authorization: Bearer <your secret key>"

GET /api/v1/visitors/:id/journey — the complete chronological journey for one visitor. Scope: secret key (lk_).

Path parameters

string (uuid)

required

The visitor id — the visitor_id returned by the clicks endpoint. Returns 404 if the visitor isn’t in your workspace, 400 if it isn’t a UUID.

Response

visitor

object

id, email, first_seen, last_seen.

journey

array

The visitor’s events in chronological order (oldest first) — clicks, identify events and orders — the same data the dashboard timeline renders.

{
  "visitor": {
    "id": "v3b4...",
    "email": "customer@example.com",
    "first_seen": "2026-07-01T12:00:00.000Z",
    "last_seen": "2026-07-21T09:20:00.000Z"
  },
  "journey": [
    { "type": "click", "ts": "2026-07-01T12:00:00.000Z", "channel": "newsletter", "slug": "spring" },
    { "type": "identify", "ts": "2026-07-03T08:30:00.000Z", "email": "customer@example.com" },
    { "type": "order", "ts": "2026-07-05T15:45:00.000Z", "amount": 90.0, "currency": "usd" }
  ]
}

Clicks Credits

⌘I

API Reference

Endpoints

Events & embeds

Path parameters

Response

​Path parameters

​Response

Path parameters

Response