v1

latestOpenAPI 3.1.02026-07-2694207444.7 KB
PowerSystem

Yearly Exchange

Returns an annual summary of exchanges for a year and one area.

Exchange tells how much electricity has been importer or exported for an area and delivery period. This is the actual measured flow.

This corresponds to the "Physical Flows" data type in the Entso-e Transparency Platform.

Response field descriptions

  • dailyTotalImport: total MWh imported volume
  • dailyTotalExport: total MWh exported volume
  • dailyTotalNetPosition: total net position in MWh (total import - total export).
  • dailySummaries: contains a list of daily summaries for all exchanges for that day
    • totalImport: total import volume for the day, in MWh
    • totalExport: total export volume for the day, in MWh
    • totalNetPosition: total net position for the day (total import - total export), in MWh
    • byConnections: list of all connections used for the day, with total imports and exports given in MWh
    • deliveryDateCET: the CET delivery date for this summary
  • monthlySummaries: contains a list of monthly summaries for all exchanges for that month
    • totalImport: total import volume for the day, in MWh
    • totalExport: total export volume for the day, in MWh
    • totalNetPosition: total net position for the day (total import - total export), in MWh
    • byConnections: list of all connections used for the day, with total imports and exports given in MWh
    • deliveryDateStartCET: the earliest date taken into account in this monthly summary
    • deliveryDateEndCET: the latest date taken into account in this monthly summary
  • yearlySummary: total exchange for the year
    • totalImport: total import volume for the year, in MWh
    • totalExport: total export volume for the year, in MWh
    • totalNetPosition: total net position for the year (total import - total export), in MWh
    • byConnections: list of all connections used for the year, with total imports and exports given in MWh
  • exchanges: a list of delivery periods, containing all exchanges for that period
    • byConnection: a list of all connections that has a flow for the period. Each connection is identified by an area and optionally by a connection name. The Connection name is only present if multiple connections exists on the same border. import gives the import volume in MW, export the export volume in MW and netPosition describes import-export
    • totalImport: sum of all connection import volumes given in MW
    • totalExport: sum of all connection export volumes given in MW
    • totalNetPosition: total import - total export

Data source: Entso-e Transparency platform. Update frequency and data availability depends on data being reported to Entso-e.

Sample response with valid data for area NO2 and year 2021

get/api/v2/PowerSystem/Exchanges/Yearly/ByArea

Query parameters

areastring required

One area. For example NO1. Supported: 50HZ, AMP, AT, BE, DE-LU, DK1, DK2, EE, FI, FR, LT, LV, NL, NO1, NO2, NO3, NO4, NO5, PL, SE1, SE2, SE3, SE4, TBW, TTG, TEL, BG

yearinteger required

Year in CET (format: yyyy, e.g., 2024)

Response

OK

yearinteger
deliveryAreastring nullable required
status'Missing' | 'Available'
updatedAtstring date-time
unitstring nullable
totalVolumeUnitstring nullable