Electrical Energy By Source

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

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	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"
        }
    ]
}

version 3 as of 3 weeks ago by Alisia Barrovecchio