---
title: "Get Site Summary Events"
method: GET
path: "/sites/{site_id}/summary-events"
tags: ["site summaries"]
---

# Get Site Summary Events

`GET /sites/{site_id}/summary-events`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/sites/{site_id}/summary-events`
- Auth: HTTP bearer

Read the records behind a stored summary, or this site's live window.

## Path parameters

- `site_id` string, uuid, required

## Query parameters

- `metric` 'motion' | 'screened_pre_review' | 'agent_cleared' | 'operator_reviewed' | 'false_alarm' | 'monitor' | 'voice_down' | 'dispatch', required
- `summary_id` string, uuid, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- GetSiteSummaryEventsResponse
  - `items` SiteSummaryEvent[], required: Newest contributing records first.
    - `id` string, uuid, required: Contributing record UUID; an event can have multiple records. Opaque for an Archived record shown to a Parent Manager.
    - `event_id` string, uuid, nullable, required: Event to open in the authorized review page; null if a camera move put the event outside current scope, or for an Archived event shown to a Parent Manager.
    - `occurred_at` string, date-time, required: Time counted by this metric, not necessarily event arrival.
    - `camera` string, required: Current camera label.
    - `outcome` string, required: Customer-safe outcome label, without operator identity or notes.
  - `total` integer, required: Current matching record count, before pagination; may differ from a stored snapshot.
  - `window_start` string, date-time, required: Inclusive monitoring-window start.
  - `window_end` string, date-time, required: Exclusive monitoring-window end.
  - `timezone` string, required: Site timezone, snapshotted for a stored summary.

## Other responses

- `422`: Validation Error

---

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