---
title: "Generate a 360° Management Report for an energy utility (Stadtwerk)"
method: POST
path: "/api/utility-report/generate"
tags: ["Utility Report"]
---

# Generate a 360° Management Report for an energy utility (Stadtwerk)

`POST /api/utility-report/generate`

## Request

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

Starts (or resumes) the generation of a comprehensive ~50-section HTML management report for German energy utilities.

**Report sections:**
1. Netzbetrieb & Netzplanung (capacity utilization, redispatch, residual load, CO₂)
2. Erneuerbare Energien & Einspeiser (PV, Wind, Storage from MaStR)
3. Energiemarkt & Preise (EPEX, ENTSO-E, SMARD)
4. Gasinfrastruktur & Versorgungssicherheit (AGSI/GIE)
5. Regulierung, Compliance & Marktprozesse (BNetzA EWK)
6. Kundenmanagement, Vertrieb & Prosumer (churn, leads)
7. Investitionsplanung & Business Cases
8. Digitalisierung & Systemübersicht

**Caching:** Reports are cached for 7 days (UUID filename). Identical requests return the cached report.
**Resumability:** Generation progress is saved after each phase. If generation is interrupted, retry the same request to resume.
**PDF:** Open the downloaded HTML in a browser and use Print → Save as PDF.

## Query parameters

- `token` string

## Request body

- object
  - `utilityName` string, required: Name of the energy utility
  - `region` string: Region, city or postal code for context
  - `bdew` string: BDEW code of the grid operator (optional, improves data quality)
  - `forceRefresh` boolean: Force regeneration even if a cached report exists
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Cached report (gateway/internal) or direct result (internal call)

- object
  - `success` boolean
  - `reportId` string
  - `status` 'generating' | 'completed' | 'cached'
  - `message` string
  - `downloadUrl` string

## Other responses

- `202`: REST/Gateway call accepted as async job

---

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