---
title: "Get Incident Events"
method: GET
path: "/analytics/incidents/events"
tags: ["analytics"]
---

# Get Incident Events

`GET /analytics/incidents/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/analytics/incidents/events`
- Auth: HTTP bearer

The individual events behind one incident-type count (the Incident
Data drill-down; rows open in the review panel). Same window, filters,
clock, and scoping as /analytics/incidents so lists reconcile with bars.

## Query parameters

- `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
- `hours` integer, nullable
- `start` string, date-time, nullable
- `end` string, date-time, nullable
- `parent_id` string, uuid, nullable
- `site_id` string[], nullable
- `camera_id` string[], nullable
- `limit` integer

## Response `200`

Successful Response

- GetIncidentEventsResponse
  - `window_start` string, date-time, required: Start of the window (UTC).
  - `window_end` string, date-time, required: End of the window (UTC).
  - `total` integer, required: Matching events in the window (may exceed len(items) when capped by limit).
  - `items` IncidentEventRow[], required: Newest-first event rows, capped at the requested limit.
    - `event_id` string, required: Event UUID — opens in the review panel.
    - `detected_at` string, date-time, required: When the AI interpretation was recorded (the clock the counts endpoint groups on).
    - `incident_type` string, required: IncidentType value.
    - `camera_id` string, required: Camera row UUID.
    - `camera_label` string, nullable: Camera label.
    - `site_id` string, required: Site UUID.
    - `site_name` string, nullable: Site name.
    - `parent_id` string, required: Parent (client) UUID.

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