• Register

Peak-Valley Load

https://api.terna.it/load/v2.0/peak-valley-load?dateFrom=20/02/2020&dateTo=15/03/2020
Allows you to obtain the maximum and minimum values of the total demand in addition to the coverage thereof across primary sources, with reference to a specific period.

The data coincide with those already available in the Download Center section of Transparency, where you can download them manually instead.

Authorization OAuth 2.0

Request Header

API field Type Description Format Card Example
Authorization String Token 1..1   <your access token>
businessID String Business ID 0..1 b57aca2f-41b8-4a6e-a43c-2fc5f8309f94
Accept String Definizione Header Accept 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"
peak_valley_load Obj Peak ValleyLoad 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
.peak_load_GW String Peak Load Value  1..1 34.218
.valley_load_GW String Valley Load Value  1..1 47.843

Example

cURL Request

curl --location --request GET 'curl --location --request GET 'https://api.terna.it/load/v2.0/peak-valley-load?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"
            },
            "peak_valley_load": [
                {
                    "date": "2022-04-23 03:00:00",
                    "date_tz": "Europe/Rome",
                    "date_offset": "+02:00",
                    "peak_load_GW": "",
                    "valley_load_GW": "24.35"
                },
                {
                    "date": "2022-04-23 09:00:00",
                    "date_tz": "Europe/Rome",
                    "date_offset": "+02:00",
                    "peak_load_GW": "34.719",
                    "valley_load_GW": ""
                }
            ]
}

version 27 as of 6 months ago by Alisia Barrovecchio