• Register

Installed Capacity

Differenze rispetto alla versione 1.0

  • L'endpoint da richiamare è stato modificato.
  • Aggiunto campo Offset nel risultato.
  • Aggiunto campo Timezone nel risultato.
https://api.terna.it/generation/v2.0/installed-capacity?year=2018&type=Photovoltaic
Allow to obtain data representing the installed capacity of generation plants and is represented by the net efficient power [GW].


The data coincide with those already available in the Download Center section of Transparency, where you can download them manually instead.

Authorization  OAuth 2.0

Request Header

API field Type Description Format Card Example
Authorization String Token 1..1   <your access token>
businessID String Business ID 0..1 b57aca2f-41b8-4a6e-a43c-2fc5f8309f94
Accept String Definizione Header Accept 0..1 Application/Json

Query Params

API field Type Description Format Card Example
year String year of extraction, value between the current year and the last 6 yyyy 1..1 2018
type String Type to be extracted restricted list 0..n Thermal

Type List

Type is to be chosen as an element of the set ['Thermal', 'Wind', 'Geothermal', 'Photovoltaic', 'Self-consumption', 'Hydro']

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

API field Type Description Format Card Example
result Obj Result

1..1 "result":{..}
.message String Specify the status and if successful, report the request

1..1 "message": "Operation completed for the following input. Year: 2018",
.status String Specify the status and if successful, report the request

1..1 "status": "Completed"
installed_capacity Obj Installed Capacity Structure array 0..n
.year String Date yyyy 1..1 2018
.type String Type  1..1 Thermal
.installed_capacity_GWh String Installed Capacity  1..1 61.62

Example

cURL Request

curl --location --request GET 'https://api.terna.it/generation/v2.0/installed-capacity?year=2018&type=Photovoltaic' --header 'Authorization: <token>'

Response

{
			"result": {
				"message": "Operation completed for the following input. Year: 2018, type: Photovoltaic",
				"status": "Completed"
			},
			"installed_capacity": [
				{
					"year": "2018",
					"type": "Photovoltaic",
					"installed_capacity_GWh": "20.1"
				}
			]
}