---
title: "List the supervised profile's history for the human who holds control"
method: POST
path: "/viewer-history"
---

# List the supervised profile's history for the human who holds control

`POST /viewer-history`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/viewer-history`
- Auth: none declared

## Request body

- object
  - `credential` string, required
  - `origin` string, required
  - `q` string
  - `before` string

## Response `200`

Successful response

- object
  - `entries` object[], required: Newest first.
    - `entry_id` string, required
    - `url` string, required
    - `title` string, required
    - `visited_at` string, required
    - `session_id` string, required
    - `actor` 'agent' | 'human', required
  - `next_before` string, nullable, required: Pass as before for older entries.

## Other responses

- `401`: RFC 7807 authentication problem
- `409`: RFC 7807 state/control problem
- `410`: RFC 7807 expired or replayed admission problem

---

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