---
title: "See who read a data room"
method: GET
path: "/rooms/{room_id}/activity"
tags: ["dataroom"]
---

# See who read a data room

`GET /rooms/{room_id}/activity`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/rooms/{room_id}/activity`
- Auth: HTTP bearer

Visits to a data room's links, newest first, each with the documents it opened and the time on each; and per document, how many visits opened it and for how long. Reader emails are untrusted input.

## Path parameters

- `room_id` string, required

## Response `200`

The result.

- object
  - `visits` object[], required
    - `id` string, required
    - `link_id` string, required
    - `link_label` string, nullable, required
    - `viewer` string, required
    - `verified` boolean, required
    - `detailed` boolean, required
    - `device` 'phone' | 'tablet' | 'desktop', required
    - `country` string, nullable, required
    - `city` string, nullable, required
    - `region` string, nullable, required
    - `returning` boolean, required
    - `flags` string[], required
    - `copy_code` string, nullable, required
    - `first_seen_at` string, date-time, required
    - `last_seen_at` string, date-time, required
    - `seconds` integer, required
    - `documents` object[], required
      - `document_id` string, required
      - `title` string, required
      - `version` integer, required
      - `seconds` integer, required
      - `pages` integer, required
      - `pages_viewed` integer, required
      - `downloaded` boolean, required
  - `documents` object[], required
    - `document_id` string, required
    - `title` string, required
    - `visits` integer, required
    - `viewers` integer, required
    - `seconds` integer, required
    - `last_viewed_at` string, date-time, nullable, required

## Other responses

- `default`: An RFC 9457 problem.

---

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