---
title: "A file's page marks (Pro)"
method: GET
path: "/api/v1/files/{uuid}/page-marks"
tags: ["Events"]
---

# A file's page marks (Pro)

`GET /api/v1/files/{uuid}/page-marks`

## Request

- Base URL: `https://everypage.co`
- URL: `https://everypage.co/api/v1/files/{uuid}/page-marks`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://everypage.co/oauth/authorize`, token URL `https://everypage.co/oauth/token`, scopes: `readership:read`)

Every verdict readers have left on the document's pages - `pick`, `reject` or `maybe` - as per-page tallies, a per-viewer breakdown, and document totals. Owner only; requires Pro. Scope `readership:read`.

This is a pull, not a push: the `proofing.updated` webhook fires only once per viewer per document, on their first mark, and carries no verdicts. Read this endpoint when that event arrives.

`identity` is the invitee's email address for readers who arrived through an email invite, and a pseudonymous `Anonymous reader <id>` label otherwise - treat the response as personal data.

## Query parameters

- `format` 'csv'

## Response `200`

Page marks

- object
  - `pages` object[]
    - `page` integer
    - `pick` integer
    - `reject` integer
    - `maybe` integer
  - `viewers` object[]
    - `identity` string: Invitee email address, or a pseudonymous reader label.
    - `marks` object[]
      - `page` integer
      - `mark` 'pick' | 'reject' | 'maybe'
  - `totals` object
    - `pick` integer
    - `reject` integer
    - `maybe` integer

## Other responses

- `401`: No or invalid API key, OAuth token, manage token or claim token (code `missing_token` or `invalid_token`).
- `403`: Not the owner, or the plan is below Pro.
- `404`: Unknown id, or a file you do not own on routes where 404 replaces 403 (code `not_found`).
- `429`: Over the limit - 120 requests per minute per Authorization value on /api/v1 (webhook test 10/min; the Canva lane 30/min per IP). Code `rate_limited`; wait for `Retry-After`.

---

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