Grid Operations

Network capacity utilization analysis (transformers, lines, heatmaps)

Calculate equipment loading, temporal heatmaps, and investment prioritization

post/api/grid-operations/capacity-utilization

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/grid-operations/capacity-utilization
  • 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

gridOperatorstring required

Grid operator name

datestring

Specific date for analysis

startDatestring

Start date for time range analysis

endDatestring

End date for time range analysis

voltageLevel'NS' | 'MS' | 'HS' | 'HöS' | 'all'

Voltage level filter (NS=low, MS=medium, HS/HöS=high)

includeHeatmapboolean

Include temporal utilization heatmap

includeSimultaneityFactorsboolean

Include simultaneity factor analysis

tokenstring

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

Example request

{
  "gridOperator": "Stadtwerke München",
  "date": "2026-02-01",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31"
}

Response

Successful response

object required

Changes

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