• Register

Total

[GET] https://api.terna.it/load/v2.0/total

link

Authorization  OAuth 2.0

Request Header

API field Type Description Format Card Example
businessID string 0..1
Authorization string OAuth Token 1..1 Bearer   <token>
Accept string 0..1 Application/Json

Query Params

API field Type Description Format Card Example
region string Region to be extracted 0..1 Lombardia
province string Provinces to be extracted 0..n Brescia
sector string Sector to be extracted 0..1 Industria
activity string Activity to be extracted 0..1 Attivita manifatturiere
class string Class to be extracted 0..1 Metallurgia
year string Year to be extracted integer 1..1 2022

Sector List

Activity is to be chosen as an element of the set [ 'Agricoltura', 'Domestico', 'Industria', 'Servizi' ]

Activity List

Activity is to be chosen as an element of the set [ 'Altre attività di servizi', 'Amministrazione pubblica e difesa; assicurazione sociale obbligatoria', 'Attività artistiche, sportive, di intrattenimento e divertimento', 'Attività dei servizi di alloggio e di ristorazione', 'Attività di famiglie e convivenze come datori di lavoro per personale domestico; produzione di beni e servizi indifferenziati per uso proprio da parte di famiglie e convivenze', 'Attività finanziarie e assicurative', 'Attivita' immobiliari', 'Attività manifatturiere', 'Attivita' professionali', 'Attività professionali, scientifiche e tecniche', 'Coltivazioni agricole e produzione di prodotti animali, caccia e servizi connessi', 'Commercio all'ingrosso e al dettaglio; riparazione di autoveicoli e motocicli', 'Costruzioni', 'Energia ed acqua', 'Estrazione di minerali da cave e miniere', 'Fornitura di acqua; reti fognarie, attività di gestione dei rifiuti e risanamento', 'Fornitura di energia elettrica, gas, vapore e aria condizionata', 'Illuminazione pubblica', 'Istruzione', 'Manifatturiera di base', 'Manifatturiera non di base', 'Noleggio, agenzie di viaggio, servizi di supporto alle imprese', 'Pesca e acquacoltura', 'Sanita' e assistenza sociale', 'Servizi di informazione e comunicazione', 'Servizi non vendibili', 'Servizi rete autostradale', 'Servizi vendibili', 'Servizi veterinari', 'Silvicoltura ed utilizzo di aree forestali', 'Trasporto e magazzinaggio' ]

Class List

Class is to be chosen as an element of the set [ 'Acquacoltura', 'Acquedotti', 'Alberghi, ristoranti e bar', 'Alimentare', 'Allevamento di animali', 'Alloggio', 'Altre attività di estrazione di minerali da cave e miniere', 'Altre attività di servizi per la persona', 'Altre attività professionali, scientifiche e tecniche', 'Altre industrie manifatturiere', 'Altre manifatturiere', 'Altri servizi non vendibili', 'Altri servizi vendibili', 'Amministrazione pubblica e difesa; assicuraz. sociale obbligatoria', 'Assicurazioni, riassicurazioni e fondi pensione (escluse le assicurazioni sociali obbligatorie)', 'Assistenza sanitaria', 'Assistenza sociale non residenziale', 'Attività ausiliarie dei servizi finanziari e delle attività assicurative', 'Attività creative, artistiche e di intrattenimento', 'Attività degli studi di architettura e d'ingegneria; collaudi ed analisi tecniche', 'Attività dei servizi delle agenzie di viaggio, dei tour operator e servizi di prenotazione e attività connesse', 'Attività dei servizi di ristorazione', 'Attività dei servizi di supporto all'estrazione', 'Attività dei servizi d'informazione e altri servizi informatici', 'Attività di biblioteche, archivi, musei ed altre attività culturali', 'Attività di direzione aziendale e di consulenza gestionale', 'Attivita' di famiglie e convivenze come datori di lavoro per pers. domestico', 'Attività di noleggio e leasing operativo', 'Attività di organizzazioni associative', 'Attività di produzione cinematografica, di video e di programmi televisivi, di registrazioni musicali e sonore', 'Attività di programmazione e trasmissione', 'Attività di raccolta, trattamento e smaltimento dei rifiuti; recupero dei materiali', 'Attività di ricerca, selezione, fornitura di personale', 'Attività di servizi finanziari (escluse le assicurazioni e i fondi pensione)', 'Attività di servizi per edifici e paesaggio', 'Attività di supporto all'agricoltura e attività successive alla raccolta', 'Attività di supporto per le funzioni d'ufficio e altri servizi di supporto alle imprese', 'Attività editoriali', 'Attività immobiliari', 'Attività legali e contabilità', 'Attività riguardanti le lotterie, le scommesse, le case da gioco', 'Attività sportive, di intrattenimento e di divertimento', 'Caccia, cattura di animali e servizi connessi', 'Cartaria', 'Chimica', 'Coltivazione di colture agricole non permanenti', 'Coltivazione di colture permanenti', 'Coltivazioni agricole associate all'allevamento di animali: attività mista', 'Commercio', 'Commercio al dettaglio (escluso quello di autoveicoli e di motocicli)', 'Commercio all'ingrosso (escluso quello di autoveicoli e di motocicli)', 'Commercio all'ingrosso e al dettaglio e riparazione di autoveicoli e motocicli', 'Comunicazioni', 'Confezione di articoli di abbigliamento; confezione di articoli in pelle e pelliccia', 'Costruzione di edifici', 'Credito ed assicurazioni', 'Elettricità e gas', 'Estrazione combustibili', 'Estrazione di carbone (esclusa torba)', 'Estrazione di minerali metalliferi', 'Estrazione di minerali metalliferi non ferrosi', 'Estrazione di petrolio greggio e di gas naturale', 'Fabbricazione di altri mezzi di trasporto', 'Fabbricazione di altri prodotti della lavorazione di minerali non metalliferi', 'Fabbricazione di apparecchiature elettriche ed apparecchiature per uso domestico non elettriche', 'Fabbricazione di articoli in gomma e materie plastiche', 'Fabbricazione di articoli in pelle e simili', 'Fabbricazione di autoveicoli, rimorchi e semirimorchi', 'Fabbricazione di carta e di prodotti di carta', 'Fabbricazione di coke e prodotti derivanti dalla raffinazione del petrolio', 'Fabbricazione di computer e prodotti di elettronica e ottica; apparecchi elettromedicali, apparecchi di misurazione e di orologi', 'Fabbricazione di macchinari ed apparecchiature nca', 'Fabbricazione di mobili', 'Fabbricazione di prodotti chimici', 'Fabbricazione di prodotti farmaceutici di base e di preparati farmaceutici', 'Fabbricazione di prodotti in metallo (esclusi macchinari e attrezzature)', 'Gestione delle reti fognarie', 'Illuminaz. pubblica', 'Illuminazione pubblica', 'Industria del legno e dei prodotti in legno e sughero (esclusi i mobili); fabbricazione di articoli in paglia e materiali da intreccio', 'Industria del tabacco', 'Industria delle bevande', 'Industrie alimentari', 'Industrie tessili', 'Ingegneria civile', 'Istruz.', 'Lavorazione plastica e gomma', 'Lavori di costruzione specializzati', 'Legno e mobilio', 'Magazzinaggio e attività di supporto ai trasporti', 'Materiali da costruzione', 'Meccanica', 'Metalli non ferrosi', 'Metallurgia', 'Mezzi di trasporto', 'Organizz. ed organismi extraterritoriali', 'Pesca', 'Produzione di beni e servizi indifferenziati per uso proprio da parte di famiglie e convivenze', 'Produzione di software, consulenza informatica e attività connesse', 'Produzione, trasmissione e distribuzione di energia elettrica', 'Pubblica amministrazione', 'Pubblicità e ricerche di mercato', 'Raccolta di prodotti selvatici non legnosi', 'Raccolta, trattamento e fornitura di acqua', 'Raffinazione e cokerie', 'Ricerca scientifica e sviluppo', 'Riparazione di computer e di beni per uso personale e per la casa', 'Riparazione, manutenzione ed installazione di macchine ed apparecchiature', 'Riproduzione delle piante', 'Serv. veterinari', 'Servizi di assistenza sociale residenziale', 'Servizi di supporto per la silvicoltura', 'Servizi di vigilanza e investigazione', 'Servizi per la rete autostradale', 'Servizi per la rete autostradale', 'Siderurgica', 'Silvicoltura ed altre attività forestali', 'Stampa e riproduzione di supporti registrati', 'Telecomunicazioni', 'Tessile, abbigl. e calzature', 'Trasporti', 'Trasporto aereo', 'Trasporto marittimo e per vie d'acqua', 'Trasporto terrestre e trasporto mediante condotte', 'Utilizzo di aree forestali' ]

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 200

API field Type Description Format Card Example
result Obj Result
1..1 "result":{..}
.message string
 1..1 "OK"
.status string
 1..1 "Completed"
total array 0..n "total":[{..}]
.year string integer 1..1 "2022"
.region string 1..1 "Lombardia"
.province string 1..1 "Brescia"
.sector string 1..1 "Industria"
.activity string 1..1 "Attivita manifatturiere"
.class string 1..1 "Metallurgia"
.consumption_GWh string number 1..1 "3.002,178"

Example

cURL Request

curl --location --request GET https://api.terna.it/load/v2.0/total??year=<year>®ion=<region>&province=<province>§or=<sector> 
        --header 'Authorization:Bearer <OAuth Token>'

Response


{
    "result": {
        "message": "string",
        "status": "string"
    },
    "total": [
        {
          "year": "string",
          "region": "string",
          "province": "string",
          "sector": "string",
          "activity": "string",
          "class": "string",
          "consumption_GWh": "string"
        }
    ]
}

version 3 as of 3 weeks ago by Alisia Barrovecchio