• Register

Monthly Index Industrial Electrical Consumption

[GET]  https://api.terna.it/load/v2.0/monthly-index-industrial-electrical-consumption
Descrizione completa di IMCEI

Authorization OAuth 2.0

Request Header

API field Type Description Format Card Example
businessID String Business ID 0..1 b57aca2f-41b8-4a6e-a43c-2fc5f8309f94
Authorization String Bearer Token 1..1 Bearer   <token>
Accept String 0..1 Application/Json

Query Params

API field Type Description Format Card Example
year Int Year of extraction yyyy 1..1 2021
month Int Month of extraction mm 1..1 02
sector String Sector to be extracted restricted list 0..n ALIMENTARE
tensionType String Tension Type to be extracted restricted list 0..1 AT

Sector List

Sector is to be chosen as an element of the set ['ALIMENTARE', 'ALTRI', 'CARTARIA', 'CEMENTO CALCE E GESSO', 'CERAMICHE E VETRARIE', 'CHIMICA', 'MECCANICA', 'METALLI NON FERROSI', 'MEZZI DI TRASPORTO', 'SIDERURGIA']

Tension Type List

Tension Type is to be chosen as an element of the set ['AT', 'MT']

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": "OK",
.status String Specify the status and if successful, report the request
 1..1 "status": "Completed"
monthly_index_industrial_electrical_consumption Obj Monthly Index Industrial Electrical Consumption Structure 0..n
.date String  0..1 2022-11-03 16:45:01
.date_offset String  0..1 +02:00
.region String  0..1 Lombardia
.sector String  0..1 ALTRI
.tension_type String  0..1 AT
.monthly_imcei String  0..1 56
.consumption_Gwh String  0..1 609

Example

cURL Request

curl --location --request GET 'https://api.terna.it/load/v2.0/monthly-index-industrial-electrical-consumption?year=2021&month=11' --header 'Authorization: Bearer <token>'

Response

{
        "result": {
            "message": "Operation completed for the following input. Year: 2021, month: 11",
            "status": "Completed"
        },
        "monthly_index_industrial_electrical_consumption": [
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "ALIMENTARE",
                "tension_type": "MT",
                "monthly_imcei": " 13",
                "consumption_Gwh": "6"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "ALTRI",
                "tension_type": "AT",
                "monthly_imcei": " 4",
                "consumption_Gwh": "11"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "ALTRI",
                "tension_type": "MT",
                "monthly_imcei": " 3",
                "consumption_Gwh": "6"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "CARTARIA",
                "tension_type": "AT",
                "monthly_imcei": " 12",
                "consumption_Gwh": "4"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "CARTARIA",
                "tension_type": "MT",
                "monthly_imcei": " 3",
                "consumption_Gwh": "2"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "CEMENTO CALCE E GESSO",
                "tension_type": "AT",
                "monthly_imcei": " 0",
                "consumption_Gwh": "0"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "CHIMICA",
                "tension_type": "MT",
                "monthly_imcei": " 4",
                "consumption_Gwh": "3"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "MECCANICA",
                "tension_type": "AT",
                "monthly_imcei": " 0",
                "consumption_Gwh": "0"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "MECCANICA",
                "tension_type": "MT",
                "monthly_imcei": " 9",
                "consumption_Gwh": "4"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "METALLI NON FERROSI",
                "tension_type": "MT",
                "monthly_imcei": " 2",
                "consumption_Gwh": "1"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Abruzzo",
                "sector": "MEZZI DI TRASPORTO",
                "tension_type": "AT",
                "monthly_imcei": " 7",
                "consumption_Gwh": "8"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Basilicata",
                "sector": "ALIMENTARE",
                "tension_type": "MT",
                "monthly_imcei": " 4",
                "consumption_Gwh": "2"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Basilicata",
                "sector": "ALTRI",
                "tension_type": "AT",
                "monthly_imcei": " 1",
                "consumption_Gwh": "2"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Basilicata",
                "sector": "ALTRI",
                "tension_type": "MT",
                "monthly_imcei": " 3",
                "consumption_Gwh": "5"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Basilicata",
                "sector": "CARTARIA",
                "tension_type": "MT",
                "monthly_imcei": " 2",
                "consumption_Gwh": "1"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Basilicata",
                "sector": "CEMENTO CALCE E GESSO",
                "tension_type": "AT",
                "monthly_imcei": " 4",
                "consumption_Gwh": "7"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Basilicata",
                "sector": "MEZZI DI TRASPORTO",
                "tension_type": "AT",
                "monthly_imcei": " 1",
                "consumption_Gwh": "1"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Basilicata",
                "sector": "SIDERURGIA",
                "tension_type": "AT",
                "monthly_imcei": " 3",
                "consumption_Gwh": "33"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Calabria",
                "sector": "ALTRI",
                "tension_type": "MT",
                "monthly_imcei": " 1",
                "consumption_Gwh": "1"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Calabria",
                "sector": "CEMENTO CALCE E GESSO",
                "tension_type": "AT",
                "monthly_imcei": " 1",
                "consumption_Gwh": "2"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Calabria",
                "sector": "CHIMICA",
                "tension_type": "AT",
                "monthly_imcei": " 0",
                "consumption_Gwh": "0"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Calabria",
                "sector": "CHIMICA",
                "tension_type": "MT",
                "monthly_imcei": " 1",
                "consumption_Gwh": "0"
            },
            {
                "year": "2021",
                "month": "11",
                "region": "Campania",
                "sector": "ALIMENTARE",
                "tension_type": "MT",
                "monthly_imcei": " 14",
                "consumption_Gwh": "7"
            }
        ]
}