• Register

Preliminary Macrozonal Imbalance

This endpoint will be substituted20 giugno.can be foundfees/v1.0/preliminary-macrozonal-imbalance.

https://api.terna.it/market-and-fees/v1.0/preliminary-macrozonal-imbalance?dateFrom=10/05/2022&dateTo=21/05/2022&dataType=Orario

Segno di sbilanciamento macrozonale preliminare

The data coincide with those already available in the Sunset section of MyTerna, 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 Identificativo facoltativo che può essere utilizzato per identificare il messaggio durante la fase di analisi quando si apre un ticket al support team di Terna. 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
dataType String Type of data to be extracted. If not entered, the filter is not applied and all types will be considered in the search restricted list 0..1 Orario

Lista Type

Type deve essere scelto come elemento dell'insieme ['Orario','Quarto Orario']

Response Structure

API field Type Description Format Card Example
result Obj Risultato della richiesta
1..1 "result":{..}
.message String Indica lo stato e, in caso di esito positivo, segnala la richiesta.
1..1 "message": "Operation completed for the following request: date from: 22/05/2022, date to: 23/06/2022",
.status String Indica lo stato e, in caso di esito positivo, segnala la richiesta.
1..1 "status": "Completed"
preliminary_macrozonal_imbalance Obj Preliminary Macrozonal Imbalance Struttura array 0..n
.publication_date String Date yyyy-mm-dd hh:mm:ss 1..1 2022-10-01 00:00:00
.reference_date String Date yyyy-mm-dd hh:mm:ss 1..1 2022-09-01 00:00:00
.data_type String Tipo Dato  1..1 Orario
.date_tz String Time Zone Continent/City 1..1 Europe/Rome
.macrozone String Macrozone  0..1 NORD
.zonal_aggregate_unbalance_MWh String tbd  0..1  -56
.zonal_aggregate_sign String tbd  1..1  -
.exchanges_MWh String tbd  0..1  -55
.foreign_MWh String tbd  0..1  1081

Example

cURL Request

curl -X 'GET' 'https://api-coll.terna.it/market-and-fees/v1.0/preliminary-macrozonal-imbalance?dateFrom=10/05/2022&dateTo=21/05/2022&dataType=Orario' --header 'Authorization: <token>'

Response

{
        "result": {
            "message": "Operation completed for the following input. Date from: 10/05/2022, date to: 21/05/2022, data type: Orario",
            "status": "Completed"
        },
        "preliminary_macrozonal_imbalance": [
            {
                "publication_date": "2022-05-22 00:38:00",
                "reference_date": "2022-05-21 23:00:00",
                "data_type": "Orario",
                "date_tz": "Europe/Rome",
                "macrozone": "SUD",
                "zonal_aggregate_unbalance_MWh": "466.121",
                "zonal_aggregate_sign": "+",
                "exchanges_MWh": "1808.426",
                "foreign_MWh": "-184.856"
            },
            {
                "publication_date": "2022-05-22 00:38:00",
                "reference_date": "2022-05-21 23:00:00",
                "data_type": "Orario",
                "date_tz": "Europe/Rome",
                "macrozone": "NORD",
                "zonal_aggregate_unbalance_MWh": "135.393",
                "zonal_aggregate_sign": "+",
                "exchanges_MWh": "-1808.426",
                "foreign_MWh": "5592.644"
            }
        ]
}

version 35 as of 3 weeks ago by Andrea Di Cosmo