---
title: "Get Logs Timeseries"
method: GET
path: "/logs/timeseries"
tags: ["logs"]
---

# Get Logs Timeseries

`GET /logs/timeseries`

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

## Query parameters

- `hours` integer
- `start` string, date-time, nullable
- `end` string, date-time, nullable
- `group_by` 'none' | 'camera' | 'site'
- `camera_ids` string[], nullable

## Response `200`

Successful Response

- GetLogsTimeseriesResponse
  - `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
  - `bucket_minutes` integer, required: Aggregation interval used by each point
  - `group_by` 'none' | 'camera' | 'site', required
  - `truncated` boolean
  - `truncated_count` integer
  - `generated_at` string, date-time, required: When the time series was computed
  - `series` PipelineTimeseriesSeries[], required
    - `key` string, required
    - `label` string, required
    - `points` PipelineTimeseriesPoint[], required
      - `bucket_at` string, date-time, required
      - `motions_detected` integer
      - `validator_rejected` integer
      - `validator_confirmed` integer
      - `events_total` integer
      - `agent_dismissed` integer: Events in this bucket automatically dismissed by agent mode (agent auto-dismiss decisions), never surfaced to the human queue
      - `gate_filtered` integer: Events in this bucket 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 this bucket 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
      - `errors_total` integer

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