---
title: "Export what links recorded about a reader"
method: POST
path: "/viewers/export"
tags: ["viewer"]
---

# Export what links recorded about a reader

`POST /viewers/export`

## Request

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

Every visit by this email to the workspace's links, with time per page where the reader allowed it, as JSON.

## Request body

- object
  - `email` string, email, required

## Response `200`

The result.

- object
  - `email` string, required
  - `exported_at` string, date-time, required
  - `visits` object[], required
    - `link_id` string, required
    - `document_title` string, required
    - `version` integer, nullable, required
    - `first_seen_at` string, date-time, required
    - `last_seen_at` string, date-time, required
    - `seconds` integer, required
    - `verified` boolean, required
    - `analytics` 'detailed' | 'minimal', required
    - `device` string, required
    - `country` string, nullable, required
    - `city` string, nullable, required
    - `region` string, nullable, required
    - `os` string, nullable, required
    - `browser` string, nullable, required
    - `downloaded_at` string, date-time, nullable, required
    - `pages` object[], required
      - `page` integer, required
      - `seconds` integer, required
    - `events` object[], required
      - `kind` 'link_click' | 'print_blocked', required
      - `page` integer, required
      - `target` string, nullable, required
      - `at` string, date-time, required
  - `codes_requested` integer, required
  - `questions` object[], required
    - `room` string, required
    - `text` string, required
    - `asked_at` string, date-time, required
    - `answer` string, nullable, required
  - `nda_acceptances` object[], required
    - `nda_title` string, required
    - `version` integer, required
    - `name` string, required
    - `accepted_at` string, date-time, required
    - `sealed_sha256` string, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `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)