[GET] https://api.terna.it/market/v1.0/input/afrr-requirement
These are the final 'secondary reserve' requirement data used for the execution of market sessions from MSD1 to MSD6, i.e., they represent the half-band limits to be provisioned for each market session and for the three macrozones (Continent, Sicily and Sardinia).
Authorization OAuth
2.0
Request Header
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 |
|
Response Structure 200
| API field |
Type |
Description |
Format |
Card |
Example |
| result
|
|
|
|
0..1 |
|
| .messagge
|
string |
|
|
0..1 |
OK |
| .status
|
string |
|
|
0..1 |
Completed |
| secondary_reserve_requirement
|
array |
|
|
0..n |
|
| .reference_date
|
string |
|
|
0..1 |
2023-10-04 |
| .date_tz
|
string |
|
|
0..1 |
Europe/Rome |
| .offset |
string |
|
|
0..1 |
+02:00 |
| .zone
|
string |
|
|
0..1 |
Calabria |
| .session_type
|
string |
|
|
0..1 |
MSD1 |
| .requirement_MW
|
string |
|
|
0..1 |
395 |
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 --location --request GET 'https://api.terna.it/market/v1.0/input/afrr-requirement?dateFrom=22/11/23&dateTo=22/11/23&sessionType=MSD1' --header 'Authorization: <token>'
Response
{
"result": {
"message": "string",
"status": "string"
},
"secondary_reserve_requirement": [
{
"reference_date": "string",
"date_tz": "string",
"offset": "string",
"zone": "string",
"session_type": "string",
"requirement_MW": "string"
}
]
}