---
title: "Network capacity utilization analysis (transformers, lines, heatmaps)"
method: POST
path: "/api/grid-operations/capacity-utilization"
tags: ["Grid Operations"]
---

# Network capacity utilization analysis (transformers, lines, heatmaps)

`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

Calculate equipment loading, temporal heatmaps, and investment prioritization

## Query parameters

- `token` string

## Request body

- object
  - `gridOperator` string, required: Grid operator name
  - `date` string: Specific date for analysis
  - `startDate` string: Start date for time range analysis
  - `endDate` string: End date for time range analysis
  - `voltageLevel` 'NS' | 'MS' | 'HS' | 'HöS' | 'all': Voltage level filter (NS=low, MS=medium, HS/HöS=high)
  - `includeHeatmap` boolean: Include temporal utilization heatmap
  - `includeSimultaneityFactors` boolean: Include simultaneity factor analysis
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Successful response

- object

---

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