---
title: "Get Logs Summary"
method: GET
path: "/logs/summary"
tags: ["logs"]
---

# Get Logs Summary

`GET /logs/summary`

## 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/logs/summary`
- Auth: HTTP bearer

## Query parameters

- `hours` integer
- `start` string, date-time, nullable
- `end` string, date-time, nullable

## Response `200`

Successful Response

- GetLogsSummaryResponse
  - `window_hours` integer, required: Size of the reporting window in hours
  - `window_start` string, date-time, required: Inclusive start of the window
  - `window_end` string, date-time, required: Inclusive end of the window
  - `generated_at` string, date-time, required: When this summary was computed
  - `cameras` CameraPipelineSummaryModel[], required: Per-camera event-flow health, cameras with stranded events first
    - `camera_id` string, uuid, required: UUID of the camera
    - `camera_label` string, required: Camera label
    - `kvs_stream_name` string, required: KVS stream name
    - `site_name` string, nullable: Site the camera belongs to
    - `parent_name` string, nullable: Client the camera belongs to
    - `ii_enabled` boolean, required: Whether incident intelligence (AI interpretation) is currently on for this camera
    - `events_total` integer, required: Events recorded in the window
    - `events_ai` integer, required: Events in the window that received an AI interpretation
    - `events_raw_motion` integer, required: Events in the window queued as raw motion without AI interpretation (incident intelligence off at ingest)
    - `events_stranded` integer, required: Events in the window still awaiting an AI evaluation — not queue-visible; aged into history if none arrives within 48h
    - `agent_dismissed` integer: Events in the window automatically dismissed by agent mode (agent auto-dismiss decisions), never surfaced to the human queue
    - `gate_filtered` integer: Events in the window closed before AI review by a pre-processing gate (gate_stop_auto_dismiss): DeepAlert finding no object of interest, the person confirmer (r50) not confirming DeepAlert's person, or the vehicle-flash confirmer matching a parked vehicle. DeepAlert is ~94% of it (prod, 24h to 2026-10-11). Most never reach the operator queue; an early-broadcast card is shown until the verdict closes it
    - `events_queued` integer: Events created in the window that reached the operator queue: queue-visible (verdict landed, II-off, or early-broadcast), minus those the agent closed in their own eval (auto-dismiss, routing ignore, DeepAlert gate stop) before any operator saw them
    - `stranded_backlog` integer, required: Current count of events awaiting an AI evaluation (all time, unexpired) — non-zero means evals in flight or a failing pipeline
    - `last_event_at` string, date-time, nullable: Most recent event in the window
    - `last_ai_at` string, date-time, nullable: Most recent AI-interpreted event in the window
    - `pipeline_status` string: Derived current camera pipeline state
    - `pipeline_reason` string, nullable: Stable reason code for the current state
    - `last_healthcheck_at` string, date-time, nullable
    - `last_frame_at` string, date-time, nullable
    - `last_motion_at` string, date-time, nullable
    - `last_deepalert_at` string, date-time, nullable
    - `motions_detected` integer
    - `validator_rejected` integer
    - `validator_confirmed` integer
    - `validator_fail_open` integer
    - `clip_failures` integer
    - `upload_failures` integer
    - `event_create_failures` integer
    - `ai_submit_failures` integer
    - `ai_submit_queue_full` integer: Clips refused at a full AI-submit queue in the window (never reached the AI)
    - `ai_submit_stranded` integer: Queued AI submissions abandoned at worker shutdown in the window (never reached the AI)

## 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/00252d8227c1?raw)