---
title: "Get Live View Activity"
method: GET
path: "/live-view/activity"
tags: ["live view"]
---

# Get Live View Activity

`GET /live-view/activity`

## 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/live-view/activity`
- Auth: HTTP bearer

## Query parameters

- `minutes` integer: Window length ending now. The console asks for 5.

## Response `200`

Successful Response

- GetLiveViewActivityResponse: `GET /live-view/activity`: where people were seen just now. One row per camera in the caller's scope with at least one event in the last `window_minutes` whose NEWEST interpretation is activity (any incident type except UNKNOWN, NORMAL included, and not an object-gate stop). Dismissed and agent-auto-dismissed events COUNT - the queue drops a row on disposition, which is exactly when an operator wants to keep watching the camera, so this is deliberately not the queue.
  - `window_minutes` integer, required: The window the rows were computed over, ending at generated_at.
  - `generated_at` string, date-time, required: Server clock when the rows were computed (UTC); age rows against this, not the client clock.
  - `cameras` LiveViewActivityCamera[], required: Most recent activity first. Empty when nobody was seen in the window.
    - `open_operator_alarm` boolean: An operator-raised alarm on this camera is still open. Keep activity highlighted regardless of last_activity_at until a subsequent snapshot clears it.
    - `camera_id` string, uuid, required: Camera row UUID (not the hardware camera_id) - the key the Live View picker and wall use.
    - `last_activity_at` string, date-time, required: created_at of the newest activity event on this camera inside the window (UTC). An open operator-raised alarm counts whatever its age.
    - `incident_type` 'INTRUSION' | 'TAILGATING' | 'FIGHTING' | 'ARMED_ROBBERY' | 'VEHICLE_THEFT' | 'FIRE' | 'LOITERING' | 'PACKAGE_LEFT' | 'MAINTENANCE' | 'DELIVERY' | 'MULTI_PERSON' | 'LOW_LIGHT_ACTIVITY' | 'HEIGHTENED_ACTIVITY' | 'PERSON_DOWN' | 'NORMAL' | 'UNKNOWN', required
    - `event_id` string, uuid, required: The event behind last_activity_at, for a review deep link.
    - `incident_types` IncidentType[]: Every distinct incident type this camera had in the window (each event by its newest interpretation, plus an open operator-raised alarm's chosen type), most recent first. incident_type is the first; the console colours the camera by the most severe.
    - `events_in_window` integer, required: Activity events on this camera inside the window (each counted by its newest interpretation).

## 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)