Services Sector
[GET] https://api.terna.it/load/v2.0/services-sector
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 | Milano | |
| activity | string | Activity to be extracted | 0..1 | Attivita professionali | |
| class | string | Class to be extracted | 0..1 | Attivita di direzione aziendale e di consulenza gestionale | |
| year | string | Year to be extracted | integer | 1..1 | 2022 | 
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', 'Attivita' professionali', 'Attività professionali, scientifiche e tecniche', 'Commercio all'ingrosso e al dettaglio; riparazione di autoveicoli e motocicli', 'Illuminazione pubblica', 'Istruzione', 'Noleggio, agenzie di viaggio, servizi di supporto alle imprese', 'Sanita' e assistenza sociale', 'Servizi di informazione e comunicazione', 'Servizi rete autostradale', 'Servizi veterinari', 'Trasporto e magazzinaggio' ]
Class List
Class is to be chosen as an element of the set [ 'Alloggio', 'Altre attività di servizi per la persona', 'Altre attività professionali, scientifiche e tecniche', '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 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 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 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', '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', 'Illuminaz. pubblica', 'Istruz.', 'Magazzinaggio e attività di supporto ai trasporti', 'Organizz. ed organismi extraterritoriali', 'Produzione di beni e servizi indifferenziati per uso proprio da parte di famiglie e convivenze', 'Produzione di software, consulenza informatica e attività connesse', 'Pubblicità e ricerche di mercato', 'Ricerca scientifica e sviluppo', 'Riparazione di computer e di beni per uso personale e per la casa', 'Serv. veterinari', 'Servizi di assistenza sociale residenziale', 'Servizi di vigilanza e investigazione', 'Servizi per la rete autostradale', 'Servizi postali e attività di corriere', 'Telecomunicazioni', 'Trasporto aereo', 'Trasporto marittimo e per vie d'acqua', 'Trasporto terrestre e trasporto mediante condotte' ]
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" | ||
| services_sector | array | 0..n | "services_sector":[{..}] | ||
| .year | string | integer | 1..1 | "2022" | |
| .region | string | 1..1 | "Lombardia" | ||
| .province | string | 1..1 | "Milano" | ||
| .activity | string | 1..1 | "Attivita professionali" | ||
| .class | string | 1..1 | "Attivita di direzione aziendale e di consulenza gestionale" | ||
| .consumption_GWh | string | number | 1..1 | "514,978" | 
Example
cURL Request
curl --location --request GET https://api.terna.it/load/v2.0/services-sector?year=<year>®ion=<region>&province=<province> 
        --header 'Authorization:Bearer <OAuth Token>'
    Response
{
    "result": {
        "message": "string",
        "status": "string"
    },
    "services_sector": [
        {
          "year": "string",
          "region": "string",
          "province": "string",
          "activity": "string",
          "class": "string",
          "consumption_GWh": "string"
        }
    ]
}
Docs Navigation
- How to register
- How to create an application
- How to get an Access Token
- How to make a request
- Glossary
- APIs Catalog- Adequacy
- Fees
- Generation- Actual Generation
- Renewable Generation
- Energy Balance
- Installed Capacity
- Wind Production Forecast
- Renewable Source Capacity
- Generation Plants
- Thermoelectric Capacity
- Electrical Energy By Source
- Renewable Sources Production
- Hydric
- Gross vs CO2 emissions per fuel
- Thermoelectric Production
- Thermoelectric Heat
 
- Load
- Market
- Outages
- Transmission