---
title: "List the visits active in a period"
method: GET
path: "/api/activity/visits"
tags: ["Activity"]
---

# List the visits active in a period

`GET /api/activity/visits`

## Request

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

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `userId` string
- `limit` integer
- `beforeAt` string, date-time
- `beforeId` string

## Response `200`

Response for status 200

- object
  - `visits` 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
  - `hasMore` boolean, required

## Other responses

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

## Changes

- **2026-10-20** `408316254546`: 1 info
  - added the required property `visits/items/interactions` to the response with the `200` status
- **2026-10-20** `2529bf887ba6`: 1 breaking
  - removed the required property `visits/items/interactions` from the response with the `200` status
- **2026-10-20** `8df745541b3a`: 2 info
  - added the optional property `visits/items/actor/anyOf[subschema #2]/definitionId` to the response with the `200` status
  - added the required property `visits/items/interactions` to the response with the `200` status
- **2026-10-20** `8c53eb806aa9`: 1 breaking, 1 warning
  - removed the required property `visits/items/interactions` from the response with the `200` status
  - removed the optional property `visits/items/actor/anyOf[subschema #2]/definitionId` from the response with the `200` status
- **2026-10-18** `acc4f81854a0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sixb-ai/apis/sixb-api/changes/api/activity/visits/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)