Netztransparenz

Query German TSO transparency data (netztransparenz.de) including NRV balance, balancing prices, reserve activation, and renewable forecasts.

Query Netztransparenz timeseries data

post

Query German TSO transparency data (netztransparenz.de) including:

• NRV balance (grid control cooperation)

• Balancing energy prices (reBAP, ID-AEP, AEP estimator)

• Reserve power activation (aFRR, mFRR, FCR)

• Renewable energy marketing and forecasts

• Emergency measures (additional measures, emergency assistance, interruptible loads)

TSOs (Transmission System Operators):

• 50Hertz (Eastern Germany)

• Amprion (Western Germany)

• TenneT TSO (Northern Germany)

• TransnetBW (Southern Germany)

• gesamt (Germany-wide aggregate)

Variables with Per-TSO Data: Reserve activation (aktivierte_srl_, aktivierte_mrl_, srl_optimierung_, mrl_optimierung_, difference_, prl_, zusatzmassnahmen_, nothilfe_), interruptible loads (abschaltbare_lasten_), and control area balance (rz_saldo_) have data for all 4 individual TSOs plus the gesamt aggregate.

Response Formats:

• json: Columnar JSON format {column: [values], ...}

• arrow: Apache Arrow IPC stream for efficient processing

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

formatstring · enumOptional

Response format: 'json' for columnar JSON or 'arrow' for Apache Arrow format

Default: jsonPossible values:

Body

application/json

Query parameters for Netztransparenz timeseries data.

Supports filtering by:

• variables: List of variable types (optional, returns all if not set)
• tsos: List of TSOs to filter by (optional)
• subcategories: List of technology subcategories (optional)
• directions: List of directions - positive/negative (optional)
• start_time: Start of time range (required)
• end_time: End of time range (optional - if None, no upper bound applied)

Note: end_time can be None to include all future data, which is useful for day-ahead forecasts that extend into tomorrow.

variablesany ofOptional

List of Netztransparenz variable types to query. If not set, returns all variables.

Example: ["nrv_saldo_betrieblich","aep_schaetzer_betrieblich"]

or

nullOptional

tsosany ofOptional

List of TSOs to filter by (e.g., ['50Hertz', 'Amprion'])

Example: ["50Hertz","Amprion"]

or

nullOptional

subcategoriesany ofOptional

List of subcategories (only for ABSM relief regions or AEP module variables)

Example: ["H1","H2","T1"]

or

nullOptional

directionsany ofOptional

List of directions (e.g., ['positive', 'negative'])

Example: ["positive","negative"]

or

nullOptional

start_timestring · date-timeRequired

Start time for the query (inclusive)

Example: 2025-12-01T00:00:00Z

end_timeany ofOptional

End time for the query (exclusive). If None, no upper bound is applied (useful for day-ahead forecasts)

Example: 2025-12-15T00:00:00Z

string · date-timeOptional

or

nullOptional

aggregationstring · enumOptional

Temporal aggregation to apply

Default: nonePossible values:

include_metadatabooleanOptional

Include metadata column in response

Default: false

time_zoneany ofOptional

IANA time zone name for time formatting (e.g., 'Europe/Berlin', 'America/New_York'). Defaults to UTC

Example: UTC

stringOptional

or

nullOptional

order_byany ofOptional

Columns to order by

Example: ["time","tso"]

string[]Optional

or

nullOptional

paginationany ofOptional

Pagination parameters

or

nullOptional

Responses

200

Successfully retrieved Netztransparenz data

application/jsonapplication/vnd.apache.arrow.stream

anyOptional

400

Invalid query parameters

401

Authentication required

403

Insufficient permissions

422

Validation Error

application/json

post

/v1/netztransparenz/data

HTTPcURLJavaScriptPython

POST /v1/netztransparenz/data HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "variables": [
    "nrv_saldo_betrieblich"
  ],
  "start_time": "2025-12-01T00:00:00Z",
  "end_time": "2025-12-02T00:00:00Z"
}

Query NRV balanceQuery balancing pricesQuery reserve activation by TSOQuery renewable generation forecasts

{
  "time": [
    "2025-12-01T00:00:00Z",
    "2025-12-01T00:15:00Z"
  ],
  "ts_end": [
    "2025-12-01T00:15:00Z",
    "2025-12-01T00:30:00Z"
  ],
  "variable_name": [
    "nrv_saldo_betrieblich",
    "nrv_saldo_betrieblich"
  ],
  "subcategory": [
    "",
    ""
  ],
  "value": [
    150.5,
    -82.3
  ],
  "value_name": [
    "",
    ""
  ],
  "unit": [
    "MW",
    "MW"
  ],
  "tso": [
    "",
    ""
  ],
  "direction": [
    "",
    ""
  ]
}

List available Netztransparenz variables

get

Get a list of available Netztransparenz variable types with metadata including:

• Variable name

• Description

• Unit of measurement

• Whether variable uses TSO or subcategory filters

Variable Categories:

• Renewable Marketing (vermarktung_*)

• Day-Ahead Forecast (hochrechnung_*)

• NRV Balance (nrv_saldo_, rz_saldo_)

• Balancing Prices (rebap_qualitaetsgesichert, idaep, aep_schaetzer_*)

• Reserve Activation (aktivierte_srl_, aktivierte_mrl_, prl_*)

• Emergency Measures (zusatzmassnahmen_, nothilfe_, abschaltbare_lasten_*)

Authentication: Requires API key.

Authorizations

HTTPBearer

Responses

200

Successfully retrieved variable list

application/json

Result for available variables query.

401

Authentication required

get

/v1/netztransparenz/variables

HTTPcURLJavaScriptPython

GET /v1/netztransparenz/variables HTTP/1.1
Accept: */*

{
  "variables": [
    {
      "name": "nrv_saldo_betrieblich",
      "description": "NRV balance - operational (real-time)",
      "unit": "MW",
      "uses_tso": false,
      "uses_subcategory": false,
      "uses_direction": false
    }
  ]
}

List available TSOs

get

Get a list of available German Transmission System Operators (TSOs).

The four TSOs operating the German high-voltage grid, plus the aggregate:

• 50Hertz - Eastern Germany

• Amprion - Western Germany

• TenneT TSO - Northern Germany

• TransnetBW - Southern Germany

• gesamt - Germany-wide aggregate (sum of all TSOs)

Optionally filter by variable to see which TSOs have data for a specific variable. Many reserve activation variables now have per-TSO data in addition to the aggregate.

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

variableany ofOptional

Optional variable to filter TSOs by

string · enumOptional

Netztransparenz timeseries variable types.

Variables are organized by category matching the data dictionary.

Possible values:

or

nullOptional

Responses

200

Successfully retrieved TSO list

application/json

Result for available TSOs query.

tsosstring[]Required

401

Authentication required

422

Validation Error

application/json

get

/v1/netztransparenz/tsos

HTTPcURLJavaScriptPython

GET /v1/netztransparenz/tsos HTTP/1.1
Accept: */*

{
  "tsos": [
    "50Hertz",
    "Amprion",
    "TenneT TSO",
    "TransnetBW",
    "gesamt"
  ]
}

List available subcategories

get

Get a list of available subcategories (technology types) for data that is broken down by energy source.

Subcategories include:

• solar - Solar photovoltaic

• wind_onshore - Onshore wind

• wind_offshore - Offshore wind

• wind - Combined wind (used in some endpoints)

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

variableany ofOptional

Optional variable to filter subcategories by

string · enumOptional

Netztransparenz timeseries variable types.

Variables are organized by category matching the data dictionary.

Possible values:

or

nullOptional

Responses

200

Successfully retrieved subcategory list

application/json

Result for available subcategories query.

subcategoriesstring[]Required

401

Authentication required

422

Validation Error

application/json

get

/v1/netztransparenz/subcategories

HTTPcURLJavaScriptPython

GET /v1/netztransparenz/subcategories HTTP/1.1
Accept: */*

{
  "subcategories": [
    "solar",
    "wind_onshore",
    "wind_offshore"
  ]
}