---
title: "Regional load forecast with LLM reasoning and real MaStR capacity anchors"
method: POST
path: "/api/residual-load/load-forecast-regional"
tags: ["Residual Load"]
---

# Regional load forecast with LLM reasoning and real MaStR capacity anchors

`POST /api/residual-load/load-forecast-regional`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/residual-load/load-forecast-regional`
- Auth: none declared

LLM-based regional load forecast enriched with **real MaStR installation data** injected into the reasoning prompt.

**What is real vs. LLM-estimated:**
| Component | Data source |
|-----------|-------------|
| Installed PV capacity (MW, installation count) | MaStR (real) |
| Installed wind capacity (MW, installation count) | MaStR (real) |
| SMARD population scaling factor | SMARD.de (real) |
| Load profile shape, calendar effects, procurement recommendation | LLM reasoning |

**Graceful degradation:** If MaStR queries time out, the tool falls back to placeholder values and the LLM call still completes.

**Use cases:**
- Stadtwerk procurement planning with natural-language recommendations
- KPI summaries for management dashboards
- When full hour-by-hour time-series (see `netResidualLoad`) is not needed

## Query parameters

- `token` string

## Request body

- object
  - `region` string: City or region name
  - `forecastDays` number: Number of days to forecast (1–7)
  - `populationOverride` number: Known population of the grid area. Improves load scaling accuracy.
  - `gridOperatorMastrId` string: MaStR Netzbetreiber-ID for EE capacity lookup
  - `bundesland` string: Federal state for MaStR capacity query
  - `postleitzahl` string: 5-digit postal code for MaStR capacity query
  - `additionalContext` string: Extra context for the LLM (e.g. "large BASF industrial plant in area")
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Load forecast generated successfully

- object
  - `success` boolean
  - `data` object: LLM-generated load forecast analysis with real MaStR capacity anchors

---

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