---
title: "Get full KPI snapshot for a single VNB"
method: GET
path: "/api/vnb-monitor/:bdewCode"
tags: ["VNBMonitor"]
---

# Get full KPI snapshot for a single VNB

`GET /api/vnb-monitor/:bdewCode`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/vnb-monitor/:bdewCode`
- Auth: none declared

Returns aggregated KPIs from EWK, MaStR, and market data for a German grid operator (VNB). Results are cached with a configurable TTL.

## Path parameters

- `bdewCode` string, required

## Query parameters

- `refresh` boolean
- `alerts` boolean
- `lang` 'de' | 'en'
- `token` string

## Response `200`

Full KPI snapshot

- object
  - `schemaVersion` string
  - `bdewCode` string
  - `timestamp` string, date-time
  - `identity` object
  - `ewk` object
  - `mastr` object
  - `market` object
  - `alerts` unknown[]
    - unknown
  - `alertSummary` object

## Other responses

- `404`: VNB not found
- `503`: All data sources unavailable

---

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