---
title: "Grid operation data (load, frequency, flows, redispatch)"
method: POST
path: "/api/grid-operations/grid-data"
tags: ["Grid Operations"]
---

# Grid operation data (load, frequency, flows, redispatch)

`POST /api/grid-operations/grid-data`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/grid-operations/grid-data`
- Auth: none declared

Query real-time and historical grid operation data for network planning, congestion analysis, and frequency stability studies.

**Data Types**:
- **load**: Grid load profiles (consumption patterns, peak loads, valley periods)
  - Use cases: Demand forecasting, procurement planning, capacity adequacy assessment
  - Resolution: 15-minute intervals (96 data points/day)

- **frequency**: Grid frequency measurements (50 Hz nominal, ±0.2 Hz operational range)
  - Use cases: Frequency stability analysis, ROCOF studies, balancing energy optimization
  - Critical: <49.8 Hz or >50.2 Hz indicates grid stress

- **flows**: Power flows between grid areas (import/export, cross-border, internal)
  - Use cases: Grid congestion analysis, redispatch forecasting, interconnector utilization
  - Identifies: Bottlenecks, structural congestion, trading opportunities

- **redispatch**: Redispatch measures and curtailment events
  - Use cases: Cost monitoring (€300M+/year in Germany), investment justification, risk assessment for new installations
  - Critical for: Redispatch 2.0 compliance (installations ≥100 kW), NEST project justification (§11 EnWG)

**Key Applications**:
- Grid congestion analysis and forecasting
- Redispatch cost monitoring and optimization
- Frequency stability studies (TSO coordination)
- Cross-border capacity utilization
- Investment planning (grid expansion vs. smart grid solutions)

## Query parameters

- `token` string

## Request body

- object
  - `dataType` 'load' | 'frequency' | 'flows' | 'redispatch', required: Type of grid data to retrieve
  - `region` string, required: Region/grid operator name
  - `date` string, required: Date (YYYY-MM-DD)
  - `gridOperator` string: Optional: Specific grid operator
  - `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)