Utility Report

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

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.

post/api/utility-report/generate

Request

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

Query parameters

tokenstring

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.

Request body

utilityNamestring required

Name of the energy utility

regionstring

Region, city or postal code for context

bdewstring

BDEW code of the grid operator (optional, improves data quality)

forceRefreshboolean

Force regeneration even if a cached report exists

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "utilityName": "Stadtwerke Heidelberg GmbH",
  "region": "Heidelberg",
  "bdew": "9907462000006"
}

Response

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

successboolean
reportIdstring
status'generating' | 'completed' | 'cached'
messagestring
downloadUrlstring

Changes

No recorded changes to this operation across all 2 revisions of this API.