---
title: "Trace Overview"
method: GET
path: "/api/v1/traces/overview"
tags: ["sessions"]
---

# Trace Overview

`GET /api/v1/traces/overview`

## Request

- Base URL: `https://cp.xenovia.io` (the document declares no server; this is the origin it was published from)
- URL: `https://cp.xenovia.io/api/v1/traces/overview`
- Auth: none declared

Per-interval verdict, evaluation, token and latency totals plus
per-agent activity over every telemetry row in the window.

## Query parameters

- `interval` 'hour' | 'six_hours' | 'day'
- `agent_id` string, uuid, nullable
- `from` string, date-time, nullable
- `to` string, date-time, nullable

## Headers

- `Authorization` string, nullable

## Response `200`

Successful Response

- TraceOverviewResponse: Aggregates over every telemetry row in the window, so a dashboard never has to page raw rows (and sample them) to draw its tiles.
  - `interval` 'hour' | 'six_hours' | 'day', required
  - `buckets` TraceOverviewBucket[], required
    - `bucket_start` string, date-time, required
    - `allowed` integer
    - `blocked` integer
    - `redacted` integer
    - `escalated` integer
    - `failed` integer
    - `evaluations` integer
    - `input_tokens` integer
    - `output_tokens` integer
    - `requests` integer
    - `request_latency_ms_sum` integer
    - `governed_requests` integer
    - `governance_latency_ms_sum` integer
  - `governance_latency_ms_p50` integer, nullable
  - `governance_latency_ms_p95` integer, nullable
  - `agents` TraceOverviewAgent[], required
    - `agent_id` string, uuid, required
    - `records` integer, required
    - `successful_records` integer, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `last_observed_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `3e25bef24f8f`: 2 info
  - added the optional property `governance_latency_ms_p50` to the response with the `200` status
  - added the optional property `governance_latency_ms_p95` to the response with the `200` status
- **2026-10-04** `b475b750a0b7`: 2 info
  - added the optional property `buckets/items/governance_latency_ms_sum` to the response with the `200` status
  - added the optional property `buckets/items/governed_requests` to the response with the `200` status
- **2026-10-01** `b83e72c3bf26`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/xenovia/apis/controlplane/changes/api/v1/traces/overview/get.md)

---

[API](https://skmtc.dev/xenovia/apis/controlplane.md) - [All operations](https://skmtc.dev/xenovia/apis/controlplane/llms.txt) - [OpenAPI document](https://skmtc.dev/xenovia/apis/controlplane/revisions/3e25bef24f8f?raw)