---
title: "Get available BDEW codes for a utility name"
method: POST
path: "/api/utility-report/get-bdew-options"
tags: ["Utility Report"]
---

# Get available BDEW codes for a utility name

`POST /api/utility-report/get-bdew-options`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/utility-report/get-bdew-options`
- Auth: none declared

Returns all BDEW codes available for the given utility name, grouped by market role.
This is useful when a user wants to generate a report but doesn't know the BDEW code.
A single Stadtwerk may have multiple BDEW codes for different roles (Lieferant, Bilanzgruppe, etc.).

## Query parameters

- `token` string

## Request body

- object
  - `utilityName` string, required: Name of the energy utility
  - `region` string: Optional region/city for context
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Available BDEW code options

- object
  - `success` boolean
  - `utilityName` string
  - `optionsCount` number
  - `options` object[]
    - `bdew` string: BDEW code (e.g., "9907462000006")
    - `name` string: VNB name
    - `city` string, nullable
    - `roles` string[]: Market roles (e.g., ["Lieferant", "Bilanzgruppe"])
  - `message` 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)