Skip to content

Scheduled Foreign Exchange

Differences with version 1.0

  • The endpoint for the request has been changed.
  • Added Offset field in the result.
  • Added Timezone field in the result. 
https://api.terna.it/transmission/v2.0/scheduled-foreign-exchange?dateFrom=10/10/2021&dateTo=10/11/2021
Allows to obtain data representing scheduled trade exchanges between Italy, neighbouring TSOs, Corsica and Malta. Every day, the hourly trade schedule between the market zones is published.
Data from the day before the current day are present and are updated at midnight of the current day.

The data coincide with those already available in the Download Center section of the Transparency Report on Terna.it website, where you can download them manually instead. These are historical data (up to D-1), refreshed at midnight of every day D.

The data is published at the end of implicit and explicit capacity allocation processes and is in aggregate form for all time periods (yearly, monthly, day-ahead, intraday) considering the Trans European Replacement Reserves Exchange (TERRE) values. Here available data over the last five years period, besides the ones from the running year.

Authorization OAuth 2.0

Request Header

API field Type Description Format Card Example
Authorization String Authorization token obtained through Client Id and Client Secret. 1..1   <your access token>
businessID String Optional identifier that can be used to identify the message during the analysis phase when opening a ticket to Terna's support team. 0..1 b57aca2f-41b8-4a6e-a43c-2fc5f8309f94
Accept String The "Accept" header tells the server what type of content is preferred in the response. 0..1 Application/Json

Query Params

API field Type Description Format Card Example
dateFrom String Starting date of extraction dd/mm/yyyy 1..1 15/2/2021
dateTo String Final date of extraction dd/mm/yyyy 1..1 15/2/2021

Response Structure

API field Type Description Format Card Example
result Obj Result
1..1 "result":{..}
.message String Specify the status and if successful, report the request
1..1 "message": "Operation completed for the following input. Date from: 23/04/2022, date to: 23/04/2022",
.status String Specify the status and if successful, report the request
1..1 "status": "Completed"
scheduled_foreign_exchange Obj Scheduled Foreign Exchange Structure array 0..n
.date String Date yyyy-mm-dd hh:mm:ss 1..1 2020-02-12 23:00:00
.date_tz String Time Zone Continent/City 1..1 Europe/Rome
.date_offset String Time Offset 1..1 +02:00
.country String Country  1..1 Austria
.import String Import  1..1 295
.export String Export  1..1 0
.scheduled_foreign_exchange_MW String Scheduled Foreign Exchange  1..1 295

Example

cURL Request

curl --location --request GET 'https://api.terna.it/transmission/v2.0/scheduled-foreign-exchange?dateFrom=23/04/2022&dateTo=23/04/2022' --header 'Authorization: <token>'

Response

{
            "result": {
                "message": "Operation completed for the following input. Date from: 23/04/2022, date to: 23/04/2022",
                "status": "Completed"
            },
            "scheduled_foreign_exchange": [
                {
                    "date": "2022-04-23 23:00:00",
                    "date_tz": "Europe/Rome",
                    "date_offset": "+02:00",
                    "country": "Slovenia",
                    "import": "0",
                    "export": "0",
                    "scheduled_foreign_exchange_MW": "0"
                },
                {
                    "date": "2022-04-23 23:00:00",
                    "date_tz": "Europe/Rome",
                    "date_offset": "+02:00",
                    "country": "Montenegro",
                    "import": "0",
                    "export": "0",
                    "scheduled_foreign_exchange_MW": "0"
                }
            ]
}