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