> ## Documentation Index
> Fetch the complete documentation index at: https://doc.trackrev.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Visitor journey

> The full chronological journey for one visitor — every click, identify and order, oldest first.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.trackrev.io/api/v1/visitors/<visitor-id>/journey" \
    -H "Authorization: Bearer <your secret key>"
  ```
</RequestExample>

`GET /api/v1/visitors/:id/journey` — the complete chronological journey for one visitor.

**Scope:** secret key (`lk_`).

## Path parameters

<ParamField path="id" type="string (uuid)" required>
  The visitor id — the `visitor_id` returned by the [clicks](/developers/endpoints/clicks) endpoint.
  Returns `404` if the visitor isn't in your workspace, `400` if it isn't a UUID.
</ParamField>

## Response

<ResponseField name="visitor" type="object">
  `id`, `email`, `first_seen`, `last_seen`.
</ResponseField>

<ResponseField name="journey" type="array">
  The visitor's events in chronological order (oldest first) — clicks, identify events and orders —
  the same data the dashboard timeline renders.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "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" }
    ]
  }
  ```
</ResponseExample>