API Reference

Six services, one credential.

Every TenneT grid-data API, grouped by service. Public endpoints accept a sandbox key; operator endpoints require a signed access agreement.

Real-time Metrics

Sub-second cadence frequency, demand, and generation-mix readings.

BASE URL
https://api.tennet.eu/v1/metrics
  • GET
    /metrics
    Latest reading for a region + series.
    Public
  • GET
    /metrics/history
    Historical series, time-range filter.
    Public
  • GET
    /metrics/regions
    List of available control areas.
    Public

Day-Ahead Forecasts

Hourly demand + generation forecasts published at gate-closure.

BASE URL
https://api.tennet.eu/v1/forecast
  • GET
    /forecast/day-ahead
    Day-ahead demand by hour.
    Public
  • GET
    /forecast/generation
    Day-ahead generation mix.
    Public
  • GET
    /forecast/wind
    Wind generation forecast.
    Public
  • GET
    /forecast/solar
    Solar generation forecast.
    Public

Dispatch & Reserves

Operator-only: live dispatch instructions and reserve margin.

BASE URL
https://api.tennet.eu/v1/dispatch
  • GET
    /dispatch/units
    Generator-level dispatch state.
    Operator
  • GET
    /dispatch/reserves
    Real-time reserve margin per area.
    Operator
  • POST
    /dispatch/instructions
    Submit a dispatch instruction (BA only).
    Operator

Interconnect Flows

Cross-border physical flow telemetry between control areas.

BASE URL
https://api.tennet.eu/v1/interconnect
  • GET
    /interconnect/flows
    Live MW flow on each interconnect.
    Public
  • GET
    /interconnect/capacity
    Net transfer capacity, day-ahead.
    Public

Outages & Maintenance

Planned and unplanned outages affecting grid assets.

BASE URL
https://api.tennet.eu/v1/outages
  • GET
    /outages
    Active and upcoming outage events.
    Public
  • GET
    /outages/{id}
    Single outage detail + timeline.
    Public

Historical Archive

10-year archive of metrics, dispatch, and settlement data.

BASE URL
https://api.tennet.eu/v1/archive
  • GET
    /archive/metrics
    Historical metrics, paged by month.
    Public
  • GET
    /archive/settlements
    Imbalance settlement data.
    Operator
OpenAPI specs available
Each service publishes a versioned OpenAPI 3.1 spec. Import into Postman, Insomnia, or your codegen pipeline.
Read the quickstart →