Gets the most recent operational data values for a block.

Gets the most recent operational data values for a block.

Returns a JSON representation of the selected operational data and its metadata for the current 15-minute block window.

The user selects the relevant categories of operational data through the query parameter categories, which is a comma separated list. E.g. categories=powerCapacityChargeAvailable,powerCapacityDischargeRated The following categories are available for blocks:

powerCapacityChargeRated: The rated charge power capacity of the block in kW, e.g. 8000.0.

powerCapacityChargeAvailable: The available charge power capacity of the block in kW, e.g. 8000.0.

powerCapacityDischargeRated: The rated discharge power capacity of the block in kW, e.g. 8000.0.

powerCapacityDischargeAvailable: The available discharge power capacity of the block in kW, e.g. 8000.0.

boundaryPower: The wholesale power that the asset reaches at the boundary between delivery periods in kW. For example, 4000.0 kW at 12:15 implies that asset will be delivering exactly 4000 kW at exactly 12:15, which is the boundary between the [12:00, 12:15] and [12:15, 12:30] delivery periods. This will in general be different from the scheduled power values for a delivery period which are reflective of the average power delivered over each periods. For more information on relevant ramping constraints, see the layr user guide.

deliveryPeriodSetpoint: The wholesale power the asset ramps to between the two adjacent boundary powers in kW, considering the ramping constraints. For example, 4500.0 kW at 12:00 means the asset ramps to 4500 kW somewhere within the [12:00, 12:15] delivery period. The setpoint is in general different from the schedule value, as the schedule value describes the average power throughout a quarter. Each setpoint is documented against the timestamp of its quarter — i.e., a setpoint with value 4500.0 kW and timestamp 12:15 corresponds to the [12:15, 12:30] delivery period. Note that the setpoint level is not necessarily achieved at that exact point in time, but normally somewhere within the quarter. For more information on relevant ramping constraints, see the layr user guide.

schedule: The active scheduled power output/input of the block in kW, e.g. 5000.0.

acceptedSchedule: The accepted schedule power for the block in kW, e.g. 4800.0.

adjustedSchedule: The adjusted schedule power for the block in kW, e.g. 3800.0.

undeliverableSchedule: The portion of the virtual asset’s scheduled wholesale power in kW that is considered “protected” during an ongoing unavailability. State of energy changes that result from this power will be accounted against the frozen-energy of the asset.

Along with the selected operational data, a metadata object is returned which provides the unit for the selected datapoint.

For detailed information about schedule adjustments including the reason for adjustments, use the block adjustments endpoint.

This endpoint automatically calculates the current 15-minute block window based on the current time. The block window is determined by truncating the current time to the nearest 15-minute boundary. For example, if the current time is 2025-07-11T22:07:30Z, the endpoint will return data for the block window starting at 2025-07-11T22:00:00Z and ending at 2025-07-11T22:15:00Z.

Unlike the regular block operational data endpoint, this endpoint does not require start and end parameters as it automatically uses the current block window.

An example response would be:

{
  "data": {
    "powerCapacityChargeAvailable": {
      "metaData": {
        "unit": "kW"
      },
      "dataPoints": [
        {
          "timestamp": "2025-07-11T22:00:00Z",
          "value": 8000.0
        }
      ]
    },
    "powerCapacityDischargeRated": {
      "metaData": {
        "unit": "kW"
      },
      "dataPoints": [
        {
          "timestamp": "2025-07-11T22:00:00Z",
          "value": 8000.0
        }
      ]
    },
    "schedule": {
      "metaData": {
        "unit": "kW"
      },
      "dataPoints": [
        {
          "timestamp": "2025-07-11T22:00:00Z",
          "value": 5000.0
        }
      ]
    }
  }
}