---
title: "VNB overview — aggregated dashboard data for one grid operator"
method: GET
path: "/api/dashboard-api/vnb-overview"
tags: ["Dashboard API"]
---

# VNB overview — aggregated dashboard data for one grid operator

`GET /api/dashboard-api/vnb-overview`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/dashboard-api/vnb-overview`
- Auth: none declared

Returns VNB identity, KPIs (installations, capacity, EWK scores, MaStR quality), latest agent results (MaStR Quality, Grid Connection, Energy Sharing, Redispatch), active VNB Monitor alerts, and datapoint health — all in a single call.

Two-phase execution: Phase 1 runs grid-operations.vnbLookupCodes and vnb-monitor.snapshot sequentially (MCP-intensive, ≤10 concurrent sessions). Phase 2 fires datapoint.health and four agent list calls in parallel (PouchDB-only). gridOperatorId from Phase 1 is forwarded to Phase 2 list calls.

If any upstream service is unavailable, the affected fields are set to `null` and the service name is appended to `_errors`.

Cache TTL: 5 minutes (key: bdewCode). Stampede-safe: concurrent requests for the same bdewCode share a single in-flight fetch promise.

## Query parameters

- `bdewCode` string, required
- `token` string

## Response `200`

Aggregated VNB overview

- object
  - `identity` object, nullable: VNB identity from grid-operations.vnbLookupCodes
    - `name` string
    - `mastrId` string
    - `bdew` string
    - `bnr` string, nullable
  - `kpis` object, nullable: Key performance indicators aggregated from VNB Monitor and Datapoint health
  - `latestAgentResults` object: Most recent report summary for each agent pipeline (null if no report exists)
    - `mastrQuality` object, nullable
    - `gridConnection` object, nullable
    - `energySharing` object, nullable
    - `redispatch` object, nullable
  - `alerts` unknown[]: Active alerts from VNB Monitor snapshot
    - unknown
  - `timestamp` string, date-time
  - `_errors` string[]: Internal services that failed — corresponding fields are null

---

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