---
title: "Read what one visit did"
method: GET
path: "/api/activity/visits/{visitId}/timeline"
tags: ["Activity"]
---

# Read what one visit did

`GET /api/activity/visits/{visitId}/timeline`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Its page views and interactions, with the actions, workflows and Agent runs its session started, and the connection it came through. At most 200 page views and interactions, and 200 recorded executions: see truncated.

## Path parameters

- `visitId` string, required

## Response `200`

Response for status 200

- object
  - `visit` object, required
    - `id` string, required
    - `actor` union, required
      - object
        - `type` 'user', required
        - `userId` string, required
      - object
        - `type` 'share', required
        - `grantId` string, required
        - `definitionId` string
    - `attribution` object, nullable, required
      - `source` string
      - `medium` string
      - `campaign` string
      - `referrer` string
    - `startedAt` string, date-time, required
    - `lastSeenAt` string, date-time, required
    - `pageViews` number, required
    - `interactions` number, required
  - `connection` union
    - object
      - `type` 'session', required
      - `device` object, required
        - `browser` string
        - `os` string
      - `clientName` string
      - `status` 'active' | 'expired' | 'revoked', required
      - `createdAt` string, date-time, required
      - `lastSeenAt` string, date-time
      - `revokedAt` string, date-time
    - object
      - `type` 'share', required
      - `grantId` string, required
      - `definitionId` string
      - `status` 'active' | 'expired' | 'revoked', required
      - `createdAt` string, date-time, required
      - `revokedAt` string, date-time
  - `entries` union[], required
    - union
      - object
        - `kind` 'page', required
        - `at` string, date-time, required
        - `sequence` number, required
        - `route` string, required
      - object
        - `kind` 'interaction', required
        - `at` string, date-time, required
        - `sequence` number, required
        - `name` string, required
        - `route` string, required
      - object
        - `kind` 'action', required
        - `at` string, date-time, required
        - `executionId` string, required
        - `actionId` string, required
        - `runId` string, required
        - `status` union, required
          - 'succeeded' | 'failed'
          - 'incomplete'
        - `runVisible` boolean, required: Whether the viewer may read the run itself.
        - `object` object
          - `objectTypeId` string, required
          - `primaryId` string, required
      - object
        - `kind` 'workflow', required
        - `at` string, date-time, required
        - `executionId` string, required
        - `workflowId` string, required
        - `runId` string, required
        - `status` union, required
          - 'queued' | 'running' | 'waiting' | 'succeeded' | 'failed' | 'cancelled'
          - 'incomplete'
        - `runVisible` boolean, required: Whether the viewer may read the run itself.
      - object
        - `kind` 'agent', required
        - `at` string, date-time, required
        - `executionId` string, required
        - `runId` string, required
        - `threadId` string, required
        - `thread` object
          - `title` string
        - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled', required
        - `messages` number, required
        - `cost` object
          - `amounts` object[], required
            - `currency` string, required
            - `amountNanos` string, required
          - `ratedCallCount` integer, required
          - `unpriceableCallCount` integer, required
          - `unvaluedCallCount` integer, required
  - `truncated` boolean, required

## Other responses

- `400`: Response for status 400
- `403`: Response for status 403
- `404`: Response for status 404

## Changes

- **2026-10-20** `ebeab1520daa`: 1 info
  - added the optional property `entries/items/anyOf[subschema #5]/thread` to the response with the `200` status
- **2026-10-20** `408316254546`: 2 info
  - added `subschema #2` to the `entries/items/` response property `anyOf` list for the response status `200`
  - added the required property `visit/interactions` to the response with the `200` status
- **2026-10-20** `2529bf887ba6`: 1 breaking, 2 info
  - removed the required property `visit/interactions` from the response with the `200` status
  - added `subschema #4` to the `entries/items/` response property `anyOf` list for the response status `200`
  - removed `subschema #2, subschema #5` from the `entries/items/` response property `anyOf` list for the response status `200`
- **2026-10-20** `8df745541b3a`: 4 info
  - added the optional property `visit/actor/anyOf[subschema #2]/definitionId` to the response with the `200` status
  - added `subschema #2, subschema #5` to the `entries/items/` response property `anyOf` list for the response status `200`
  - removed `subschema #4` from the `entries/items/` response property `anyOf` list for the response status `200`
  - added the required property `visit/interactions` to the response with the `200` status
- **2026-10-20** `2f5f2f29a59c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sixb-ai/apis/sixb-api/changes/api/activity/visits/:visitId/timeline/get.md)

---

[API](https://skmtc.dev/sixb-ai/apis/sixb-api.md) - [All operations](https://skmtc.dev/sixb-ai/apis/sixb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sixb-ai/apis/sixb-api/revisions/a227d682eaa2?raw)