Gets schedule adjustments for a virtual asset within a time range.
Gets a list of schedule adjustments for a virtual asset within a specified time range.
Returns a JSON representation of schedule adjustments, including the delivery timestamp, accepted schedule, adjusted schedule value, and the reason for the intervention.
This endpoint provides detailed information about when and why schedule adjustments were made to a virtual asset’s power schedule. Only delivery periods where a schedule was adjusted will return a value, ensuring you only see actual adjustments.
Path Parameters
organisationID(required): The organisation ID owning the virtual assetvirtualAssetID(required): The virtual asset ID for which to retrieve adjustments
Query Parameters
start(required): The start time for the query range in ISO 8601 format, e.g.2025-07-11T22:00:00Zend(required): The end time for the query range in ISO 8601 format, e.g.2025-07-11T23:00:00Z
Response Format
The response contains an array of adjustment points, each with:
timestamp: The delivery start timestampacceptedSchedule: The originally accepted schedule value in kWadjustedSchedule: The adjusted schedule value in kWreason: The reason for the adjustment (e.g., “STATE_OF_ENERGY_BOUNDARIES”, “AVAILABILITY”, etc.)
Example Response
{
"adjustments": [
{
"timestamp": "2025-07-11T22:15:00Z",
"acceptedSchedule": 480.0,
"adjustedSchedule": 380.0,
"reason": "STATE_OF_ENERGY_BOUNDARIES"
},
{
"timestamp": "2025-07-11T22:30:00Z",
"acceptedSchedule": 520.0,
"adjustedSchedule": 420.0,
"reason": "STATE_OF_ENERGY_BOUNDARIES"
}
]
}
Related Endpoints
- Virtual Asset Operational Data - Get general operational data including accepted and adjusted schedules
- Latest Virtual Asset Operational Data - Get the most recent operational data values
Headers
Access token
Path Parameters
Organisation ID
Virtual Asset ID
Body
The body is of type object.
Response
OK