- Previous: Peak-Valley Load
- Up: Load
- Next: Generation
Peak-Valley Load Details
Differenze rispetto alla versione 1.0
- L'endpoint da richiamare è stato modificato.
- Aggiunto campo Offset nel risultato.
- Aggiunto campo Timezone nel risultato.
https://api.terna.it/load/v2.0/peak-valley-load-details?dateFrom=20/02/2020&dateTo=15/03/2020&type=Wind
Allows you to complete getPeakValleyLoad, with two output fields: Primary_Source and Type.
The data coincide with those already available in the Download Center section of Transparency, where you can download them manually instead.
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 |
type | String | Type of source | restricted list | 0..n | Wind |
Type List
Type is to be chosen as an element of the set ['Thermal', 'Wind', 'Geothermal', 'Photovoltaic', 'Net Foreign Exchange', 'Self-consumption', 'Pumping-consumption', 'Hydro']
IMPORTANT NOTE: when the value entered does not match one of the expected values, an error will not be returned, but an empty body will be returned.
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_details | Obj | Peak Valley Load Detail 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 | |
.primary_source_GW | String | Primary Source | 1..1 | 1.728 | |
.type | String | Type of Sorce | 1..1 | Wind |
Example
cURL Request
curl --location --request GET 'https://api.terna.it/load/v2.0/peak-valley-load-details?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_details": [ { "date": "2022-04-23 09:00:00", "date_tz": "Europe/Rome", "date_offset": "+02:00", "peak_load_GW": "34.719", "valley_load_GW": "", "primary_source_GW": "12.545", "type": "Thermal" }, { "date": "2022-04-23 09:00:00", "date_tz": "Europe/Rome", "date_offset": "+02:00", "peak_load_GW": "34.719", "valley_load_GW": "", "primary_source_GW": "3.338", "type": "Wind" } ] }
- Previous: Peak-Valley Load
- Up: Load
- Next: Generation