Cernion EWK Monitoring (BNetzA) API
The EWK Monitoring (BNetzA) API from Cernion — 4 operation(s) for ewk monitoring (bnetza).
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-ewk-monitoring-bnetza-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Cernion Energy Tools EWK Monitoring (BNetzA) API
version: 0.99.22
description: 'MicroService Agent System for Energy Markets - REST API with AI integration.
CERNION_TOKEN: request at https://cernion.de/ or by email: dev@stromdao.com.
For the public instance at https://api.cernion.de/, create your token at https://cernion.de/cet-token/.'
servers:
- url: https://api.cernion.de
description: API Server
tags:
- name: EWK Monitoring (BNetzA)
paths:
/api/ewk-monitoring/anschlussdauer:
post:
summary: Connection waiting times (Anschlussdauer) per VNB – median weeks per voltage…
tags:
- EWK Monitoring (BNetzA)
operationId: ewk_monitoring_anschlussdauer
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Connection duration data retrieved successfully
content:
application/json:
example:
success: true
data:
results:
- vnbName: STROMDAO Netze GmbH
bnr: '10002345'
anschlussdauer_ee_ns_phase1_weeks: 14
anschlussdauer_ee_ns_phase2_weeks: 21
anschlussdauer_ee_ns_total_weeks: 35
rank: 234 / 739
statistics:
median_weeks: 28
q25_weeks: 18
q75_weeks: 42
min_weeks: 4
max_weeks: 104
total: 1
text/csv:
description: CSV download (when format=csv)
schema:
type: string
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
description: Excel XLSX download (when format=xlsx or format=xls)
schema:
type: string
format: binary
description: 'Query BNetzA EWK connection-duration data for German distribution grid operators (VNBs).
**Data source:** vnb-transparenz.de/EWK-Monitoring-BNetzA — self-reported annual data from ~820 VNBs.
**BNetzA indicators covered:**
| Indicator | Description |
|---|---|
| 4.3.1 / 4.3.2 | EE-Anlagen NS – Phase 1 (offer) / Phase 2 (commissioning) |
| 4.3.3 / 4.3.4 | EE-Anlagen MS |
| 4.3.5 / 4.3.6 | EE-Anlagen HS |
| 5.3.1 / 5.3.2 | Verbrauchsanlagen NS (wallboxes, heat pumps, storage) |
| 5.3.3 / 5.3.4 | Verbrauchsanlagen MS |
| 5.3.5 / 5.3.6 | Verbrauchsanlagen HS |
**Use cases:**
- Identify slow-connecting VNBs as consulting/software-sales targets
- §14a EnWG analysis: how quickly does a VNB connect controllable loads?
- §11 EnWG NEST compliance: benchmark a VNB against the national median
- Regulatory reporting: connection-time comparison for BNetzA submissions'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
vnbName:
type: string
description: Partial VNB name search (case-insensitive, e.g. "Netze BW", "STROMDAO Netze")
example: STROMDAO Netze
bnr:
type: string
description: BNetzA operator number for exact lookup
example: '10002345'
voltageLevel:
type: string
enum:
- NS
- MS
- HS
- all
description: 'Voltage level filter: NS = low voltage, MS = medium voltage, HS = high voltage, all = no filter'
default: all
example: NS
installationType:
type: string
enum:
- EE
- Verbrauch
- all
description: 'Installation type: EE = renewable generation, Verbrauch = consumption (wallboxes, heat pumps, storage), all = no filter'
default: all
example: EE
sortBy:
type: string
enum:
- name
- anschlussdauer_asc
- anschlussdauer_desc
description: 'Sort order: anschlussdauer_asc = fastest first, anschlussdauer_desc = slowest first'
default: anschlussdauer_asc
example: anschlussdauer_asc
limit:
type: integer
minimum: 1
maximum: 820
default: 50
description: Maximum number of VNBs to return
example: 10
offset:
type: integer
minimum: 0
default: 0
description: Pagination offset
example: 0
includeRanking:
type: boolean
default: true
description: Include national ranking (e.g. "42 / 739")
example: true
format:
type: string
enum:
- json
- csv
- xlsx
- xls
description: Output format. "csv" and "xls"/"xlsx" trigger a file download.
default: json
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
top10FastestEE_NS:
summary: Top 10 fastest VNBs for PV grid connection (NS)
value:
installationType: EE
voltageLevel: NS
sortBy: anschlussdauer_asc
limit: 10
stromdaoNetze:
summary: Anschlussdauer for a specific VNB
value:
vnbName: STROMDAO Netze
wallboxWaiting:
summary: '§14a-relevant: wallbox connection times NS'
value:
installationType: Verbrauch
voltageLevel: NS
sortBy: anschlussdauer_asc
csvExport:
summary: CSV export – all EE connection times
value:
installationType: EE
format: csv
/api/ewk-monitoring/digitalisierungsindex:
post:
summary: Digitalisation index for German VNBs – 5 categories and up to 19 sub-indicators…
tags:
- EWK Monitoring (BNetzA)
operationId: ewk_monitoring_digitalisierungsindex
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Digitalisation index data retrieved successfully
content:
application/json:
example:
success: true
data:
results:
- vnbName: Bayernwerk Netz GmbH
bnr: '10001796'
gesamtscore_pct: 72.4
smart_grids_pct: 85
digitale_prozesse_pct: 68
datenmanagement_pct: 61.5
kundenmanagement_pct: 74.8
rank: 45 / 789
statistics:
median_gesamtscore_pct: 52
q25_pct: 38
q75_pct: 67
total: 1
text/csv:
description: CSV download (when format=csv)
schema:
type: string
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
description: Excel XLSX download (when format=xlsx or format=xls)
schema:
type: string
format: binary
description: 'Query BNetzA EWK digitalisation scores for German distribution grid operators.
**Categories:**
| Category | Sub-indicators | Description |
|---|---|---|
| `gesamtscore` | c001 | Weighted overall score |
| `smart_grids` | c002, c006–c008 | Smart grids (NS/MS/HS sensors, automation) |
| `digitale_prozesse` | c003, c009–c012 | Digital processes & AI |
| `datenmanagement` | c004, c013–c015 | Data management & analytics |
| `kundenmanagement` | c005, c016–c019 | Customer portals & self-service |
| `all` | all 19 | Full profile |
**Scores:** 0–100 % (higher = more digital); raw BNetzA values are 0–1 and normalised to percent here.
**Use cases:**
- Identify VNBs with low digitalisation → software/consulting sales targets
- Benchmark a VNB against the national median before a pitch
- M&A screening: low score + high Anschlussdauer → restructuring candidate
- ESG reporting: digitisation maturity of owned/regulated DSOs'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
vnbName:
type: string
description: Partial VNB name search
example: Bayernwerk Netz
bnr:
type: string
description: BNetzA operator number for exact lookup
example: '10001796'
category:
type: string
enum:
- gesamtscore
- smart_grids
- digitale_prozesse
- datenmanagement
- kundenmanagement
- all
description: Digitalisation category to return
default: all
example: digitale_prozesse
sortBy:
type: string
enum:
- name
- score_asc
- score_desc
description: 'Sort order: score_desc = best first, score_asc = worst first'
default: score_desc
example: score_desc
limit:
type: integer
minimum: 1
maximum: 820
default: 50
description: Maximum number of VNBs to return
example: 20
offset:
type: integer
minimum: 0
default: 0
description: Pagination offset
example: 0
includeRanking:
type: boolean
default: true
description: Include national ranking
example: true
format:
type: string
enum:
- json
- csv
- xlsx
- xls
description: Output format. "csv" and "xls"/"xlsx" trigger a file download.
default: json
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
nationalRanking:
summary: National ranking by overall score (top 20)
value:
sortBy: score_desc
limit: 20
aiScore:
summary: AI/digital processes score for all VNBs
value:
category: digitale_prozesse
sortBy: score_desc
vnbProfile:
summary: Full digitalisation profile for a specific VNB
value:
vnbName: Bayernwerk Netz
category: all
csvExport:
summary: CSV export – overall scores
value:
category: gesamtscore
format: csv
/api/ewk-monitoring/umsetzungsquote:
post:
summary: Implementation rate (Umsetzungsquote) for connection requests – share of…
tags:
- EWK Monitoring (BNetzA)
operationId: ewk_monitoring_umsetzungsquote
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Implementation rate data retrieved successfully
content:
application/json:
example:
success: true
data:
results:
- vnbName: STROMDAO Netze GmbH
bnr: '10002345'
umsetzungsquote_ee_ns_pct: 100
antraege_ee_ns: 37
realisiert_ee_ns: 37
umsetzungsquote_verbrauch_ns_pct: 92.9
antraege_verbrauch_ns: 28
realisiert_verbrauch_ns: 26
rank: 145 / 745
statistics:
median_ee_ns_pct: 97.5
q25_pct: 91
q75_pct: 100
total: 1
text/csv:
description: CSV download (when format=csv)
schema:
type: string
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
description: Excel XLSX download (when format=xlsx or format=xls)
schema:
type: string
format: binary
description: 'Query BNetzA EWK implementation rates for German VNBs.
**BNetzA indicators covered:**
| Field | Indicator | Description |
|---|---|---|
| `umsetzungsquote_ee_ns` | c010 | EE-Anlagen NS |
| `umsetzungsquote_ee_ms` | c020 | EE-Anlagen MS |
| `umsetzungsquote_ee_hs` | c030 | EE-Anlagen HS |
| `umsetzungsquote_verbrauch_ns` | c041 | Consumption + storage NS |
| `umsetzungsquote_verbrauch_ms` | c053 | Consumption + storage MS |
| `umsetzungsquote_verbrauch_hs` | c064 | Consumption + storage HS |
**Also returned:** Absolute numbers (applications submitted vs. realised).
**Use cases:**
- Identify VNBs with low realisation rates → potential regulatory pressure or backlog
- §14a-relevant: how many wallbox/heat-pump applications are actually realised?
- Compliance screening: low rates may indicate structural bottlenecks
- Sales: VNBs with large backlogs need process digitalisation'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
vnbName:
type: string
description: Partial VNB name search
example: E.ON Energie Distribution
bnr:
type: string
description: BNetzA operator number for exact lookup
example: '10001796'
voltageLevel:
type: string
enum:
- NS
- MS
- HS
- all
description: Voltage level filter
default: all
example: NS
installationType:
type: string
enum:
- EE
- Verbrauch
- all
description: Installation type filter
default: all
example: EE
sortBy:
type: string
enum:
- name
- rate_asc
- rate_desc
description: 'Sort order: rate_desc = highest rate first, rate_asc = lowest first (problem cases)'
default: rate_desc
example: rate_asc
limit:
type: integer
minimum: 1
maximum: 820
default: 50
description: Maximum number of VNBs to return
example: 20
offset:
type: integer
minimum: 0
default: 0
description: Pagination offset
example: 0
includeRanking:
type: boolean
default: true
description: Include national ranking
example: true
format:
type: string
enum:
- json
- csv
- xlsx
- xls
description: Output format. "csv" and "xls"/"xlsx" trigger a file download.
default: json
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
lowestEE_NS:
summary: VNBs with lowest EE-NS realisation rate (problem cases)
value:
installationType: EE
voltageLevel: NS
sortBy: rate_asc
limit: 20
fullVnbProfile:
summary: Full realisation profile for a specific VNB
value:
vnbName: E.ON Energie Distribution
installationType: all
section14a:
summary: '§14a-relevant: consumption/wallbox connections NS'
value:
installationType: Verbrauch
voltageLevel: NS
csvExport:
summary: CSV export – EE realisation rates
value:
installationType: EE
format: csv
/api/ewk-monitoring/benchmark-vnb:
post:
summary: Full EWK benchmark profile for a single VNB – combines Anschlussdauer…
tags:
- EWK Monitoring (BNetzA)
operationId: ewk_monitoring_benchmarkVnb
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: EWK benchmark profile retrieved successfully
content:
application/json:
example:
success: true
data:
vnbName: STROMDAO Netze GmbH
bnr: '10002345'
anschlussdauer:
rank: 234 / 739
ee_ns_total_weeks: 35
verbrauch_ns_total_weeks: 17
digitalisierungsindex:
rank: 156 / 789
gesamtscore_pct: 58.2
smart_grids_pct: 71
digitale_prozesse_pct: 52
datenmanagement_pct: 48.5
kundenmanagement_pct: 61.3
umsetzungsquote:
rank: 145 / 745
ee_ns_pct: 100
verbrauch_ns_pct: 92.9
text/csv:
description: CSV download (when format=csv)
schema:
type: string
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
description: Excel XLSX download (when format=xlsx or format=xls)
schema:
type: string
format: binary
description: 'Retrieve a complete EWK performance profile for one VNB combining all three BNetzA monitoring dimensions.
**Output sections:**
1. **Anschlussdauer** – median waiting times (weeks) per voltage level / installation type with national rank
2. **Digitalisierungsindex** – all 5 category scores (0–100 %) with national rank
3. **Umsetzungsquote** – application / realisation counts and rates per voltage level / type with national rank
**Output format:** Markdown tables (for LLM/agent readability) + structured JSON for programmatic use.
**Use cases:**
- Sales pitch preparation: "Where does the customer stand vs. the national median?"
- §11 EnWG NEST: justify network expansion by demonstrating connection-time backlog
- M&A due diligence: combined performance profile for a target DSO
- BNetzA submission: self-contained EWK benchmark document'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- vnbName
properties:
vnbName:
type: string
description: VNB name – partial match accepted (e.g. "STROMDAO Netze GmbH" or "STROMDAO Netze")
example: STROMDAO Netze
bnr:
type: string
description: BNetzA operator number for exact lookup (overrides name match)
example: '10002345'
format:
type: string
enum:
- json
- csv
- xlsx
- xls
description: Output format. "csv" and "xls"/"xlsx" trigger a file download.
default: json
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
stromdaoNetze:
summary: Full EWK profile for STROMDAO Netze
value:
vnbName: STROMDAO Netze
byBnr:
summary: Exact lookup via BNetzA operator number
value:
vnbName: Netze BW
bnr: '10001796'
csvExport:
summary: CSV export of benchmark summary
value:
vnbName: Bayernwerk Netz
format: csv
components:
parameters:
TokenQuery:
name: token
in: query
required: false
schema:
type: string
description: Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Optional Cernion MCP token. If not provided, falls back to CERNION_TOKEN from environment. Request token at https://cernion.de/ or by email: dev@stromdao.com.'