• Register

Market

[GET] https://api.terna.it/load/v2.0/market

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 Lombardia
province string Provinces to be extracted 0..n Brescia
Market string Market to be extracted 0..1 Mercato libero
year string Year to be extracted integer 1..1 2022

Market List

Market is to be chosen as an element of the set [ 'Autoconsumo', 'Mercato libero', 'Mercato tutelato']

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"
market array 0..n "market":[{..}]
.year string integer 1..1 "2022"
.region string 1..1 "Lombardia"
.province string 1..1 "Brescia"
.market string 1..1 "Mercato libero"
.consumption_GWh string number 1..1 "3.002,178"

Example

cURL Request

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

Response


{
    "result": {
        "message": "string",
        "status": "string"
    },
    "market": [
        {
          "year": "string",
          "region": "string",
          "province": "string",
          "market": "string",
          "consumption_GWh": "string"
        }
    ]
}