• Register

Electrical Energy By Source

[GET] https://api.terna.it/generation/v2.0/electrical-energy-by-source

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 Abruzzo
province string Provinces to be extracted 0..n Chieti
productionType string Production type to be extracted 0..1 Netta
source string Source to be extracted 0..1 Eolico
year string Year to be extracted integer 1..1 2023

Production Type List

Production type is to be chosen as an element of the set [ 'Lorda', 'Netta']

Source List

Source is to be chosen as an element of the set [ 'Eolico', 'Fotovoltaico', 'Geotermoelettrico', 'Idrico', 'Termoelettrico' ]

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"
electrical_energy_by_source array 0..n "electrical_energy_by_source":[{..}]
.year string integer 1..1 "2023"
.production_type string 1..1 "Netta"
.region string 1..1 "Abruzzo"
.province string 1..1 "Chieti"
.source string 1..1 "Eolico"
.production_GWh string number 1..1 "323,920"

Example

cURL Request

curl --location --request GET https://api.terna.it/generation/v2.0/electrical-energy-by-source?year=<year>®ion=<region>&province=<province> 
        --header 'Authorization:Bearer <OAuth Token>'
    

Response


{
    "result": {
        "message": "string",
        "status": "string"
    },
    "electrical_energy_by_source": [
        {
          "year": "string",
          "production_type": "string",
          "region": "string",
          "province": "string",
          "source": "string",
          "production_GWh": "string"
        }
    ]
}