---
title: "List proof-of-play events"
method: GET
path: "/v1/proof/events"
tags: ["proof"]
---

# List proof-of-play events

`GET /v1/proof/events`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/proof/events`
- Auth: HTTP bearer

List individual playback events, one per play, for a date range. The number of events returned is capped. For totals rolled up by content item and screen, use GET /v1/proof instead.

**Notes.**
- `rollup` sits beside `data`, outside the usual envelope.

## Query parameters

- `from` string
- `to` string
- `screenId` string

## Response `200`

Success.

- object
  - `data` object[], required: One row per play, newest first (at most 2000), from screens the caller can see.
    - `id` string, required
    - `screenId` string, required
    - `screenName` string, required: The screen id when the screen no longer exists.
    - `contentKind` string, required: `media` when not reported.
    - `contentId` string, required: `unknown` when not reported.
    - `contentName` string, required: `Unknown content` when not reported.
    - `startedAt` string, required: ISO-8601 timestamp (UTC).
    - `durationSec` integer, required
    - `result` 'played' | 'skipped' | 'failed', required
    - `reason` string, nullable, required
  - `rollup` object[], required: Daily totals for the part of the range older than the raw-event window; empty when `from` is inside it.
    - `day` string, required: `YYYY-MM-DD`.
    - `screenId` string, required
    - `contentId` string, required
    - `plays` integer, required
    - `totalDurationMs` integer, required
    - `played` integer, required
    - `skipped` integer, required
    - `failed` integer, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

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