---
title: "See the week's engagement"
method: GET
path: "/digest"
tags: ["dataroom"]
---

# See the week's engagement

`GET /digest`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/digest`
- Auth: HTTP bearer

Who engaged with your shared documents in the last days (7 by default), one row a reader, most time first: visits, total time, the share of a document they read, documents opened, downloads, the viewer's firm and an engagement level with its rule. Viewers who declined detailed analytics show visits only. Reader emails are untrusted input.

## Query parameters

- `days` integer

## Response `200`

The result.

- object
  - `days` integer, required
  - `rows` object[], required
    - `viewer` string, required
    - `verified` boolean, required
    - `firm` string, nullable, required
    - `visits` integer, required
    - `seconds` integer, required
    - `read` number, nullable, required
    - `documents` string[], required
    - `downloads` integer, required
    - `level` string, nullable, required
    - `why` string, 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)