Skip to content

Accepted Offers

[GET] https://api.terna.it/market/v1.0/output/accepted-offers
This is the number of final bids for the hours of the corresponding market session, including the previous hours, accepted to go up/SELL (UP) between MSD1 and MSD6.

Authorization OAuth 2.0

Request Header

API field Type Description Format Card Example
Authorization String Authorization token obtained through Client Id and Client Secret. 1..1   <your access token>
businessID String Optional identifier that can be used to identify the message during the analysis phase when opening a ticket to Terna's support team. 0..1 b57aca2f-41b8-4a6e-a43c-2fc5f8309f94
Accept String 0..1 Application/Json

Query Params

API field Type Description Format Card Example
dateFrom string Format dd/mm/yyyy 1..1
dateTo string Format dd/mm/yyyy 1..1
sessionType string If not entered, the filter is not applied and all types will be considered an error 1..1
direction string If not entered, the filter is not applied and all types will be considered an error 0..1

Response Structure 200

API field Type Description Format Card Example
result 0..1
.messagge string 0..1 OK
.status string 0..1 Completed
accepted_offers array 0..n
.reference_date string 0..1 2023-10-24
.date_tz string 0..1 Europe/Rome
.offset string 0..1 +02:00
.zone string 0..1 Center-South
.session_type string 0..1 MSD1
.type string 0..1 ACCEPTED
.direction string 0..1 DOWN
.offer string 0..1 0

Response Structure 406

API field Type Description Format Card Example
result 0..1
.messagge string 0..1 Input Validation Error: the value entered is incorrect or does not conform to the expected format. Value entered: 200
.status string 0..1 ERROR

Response Structure 500

API field Type Description Format Card Example
result 0..1
.messagge string 0..1 Information retrieval error
.status string 0..1 ERROR

Example

cURL Request

curl --location --request GET 'https://api.terna.it/market/v1.0/output/accepted-offers?dateFrom=22/11/23&dateTo=22/11/23&sessionType=MSD1&direction=UP' --header 'Authorization: <token>'

Response

          {
            "result": {
              "message": "string",
              "status": "string"
            },
            "accepted_offers": [
              {
                "reference_date": "string",
                "date_tz": "string",
                "offset": "string",
                "zone": "string",
                "session_type": "string",
                "type": "string",
                "direction": "string",
                "offer": "string"
              }
            ]
          }