---
title: "Quality summary — recent reports from all agent pipelines"
method: GET
path: "/api/dashboard-api/quality-summary"
tags: ["Dashboard API"]
---

# Quality summary — recent reports from all agent pipelines

`GET /api/dashboard-api/quality-summary`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/dashboard-api/quality-summary`
- Auth: none declared

Returns the five most recent reports from each of the five agent pipelines (MaStR Quality, Grid Connection, Energy Sharing, Redispatch Ex-Post, Energy Sharing Allocation), structured as an agent-type array with last-run timestamp, key metric, and report list.

Optionally filtered by `gridOperatorId` (MaStR SNB/GNB ID). If omitted, returns the five most recent reports regardless of operator.

Cache TTL: 5 minutes (key: gridOperatorId).

## Query parameters

- `gridOperatorId` string
- `token` string

## Response `200`

Quality summary across all agent pipelines

- object
  - `agents` object[]: One entry per agent type
    - `type` string
    - `label` string
    - `lastRun` string, date-time, nullable
    - `keyMetric` object, nullable
    - `findingsCount` object, nullable: Finding counts from latest report (null for agents without findings pattern)
      - `info` integer
      - `warning` integer
      - `error` integer
    - `recentReports` unknown[]
      - unknown
  - `businessKpis` object, nullable: VDMI business KPIs for governance and process-standardisation impact
    - `vdmi_shadow_path_resolution_rate` number, nullable: Resolved share (%) of VD_SHADOW_* and VD_SILO_* findings in the observed data
    - `vdmi_n1_escalation_reduction_rate` number, nullable: Reduction (%) of escalation-like VD_GOV_* findings comparing current vs previous 30-day window
    - `vdmi_fnav_time_to_decision_gain_days` number, nullable: Median decision-time gain in days for fNAV process matrices (previous window minus current window)
  - `timestamp` string, date-time
  - `_errors` string[]

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)
