Gets the most recent operational data values for a virtual-asset.

curl --request GET \
  --url https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/operational/latest \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "data": {}
}

virtual-assets

Gets the most recent operational data values for a virtual-asset.

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=energyCapacityAvailable,energyCapacityRated The following categories are available:

chargeEfficiency: The one-way efficiency of the virtual asset’s charging operation as a ratio, e.g. 0.95.

dischargeEfficiency: The one-way efficiency of the virtual asset’s discharging operation as a ratio, e.g. 0.95.

energyCapacityRated: The rated energy capacity of the virtual asset in kWh, e.g. 8000.0.

energyCapacityAvailable: The available energy capacity of the virtual asset in kWh at the given timestamp, e.g. 8000.0.

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

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

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

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

maximumDeliverablePower: The upper bound on signed power in kW that the virtual asset may schedule for the relevant wholesale delivery period, subject to relevant limits e.g. 5000.0. Note that this value can be negative if the asset is in a state where it must charge, e.g. to respect ancillary market flexibility reserves.

minimumDeliverablePower: The lower bound on signed power in kW that the virtual asset may schedule for the relevant wholesale delivery period, subject to relevant limits e.g. -5000.0. Note that this value can be positive if the asset is in a state where it must discharge, e.g. to respect ancillary market flexibility reserves.

stateOfChargeBoundsUpper: The upper boundary of the state of charge of the virtual asset as a ratio, e.g. 0.9 if the virtual-asset is not allowed to be charged beyond 90%. This is measured relative to the currently available energy capacity, and thus should always equal stateOfEnergyBoundsUpper divided by energyCapacityAvailable.

stateOfChargeBoundsLower: The lower boundary of the state of charge of the virtual asset as a ratio, e.g. 0.1 if the virtual-asset is not allowed to be discharged below 10%. This is measured relative to the currently available energy capacity, and thus should always equal stateOfEnergyBoundsLower divided by energyCapacityAvailable.

stateOfChargeProjection: The projected state of charge of the virtual asset as a ratio, e.g. 0.50 for an asset projected to be at 50% state-of-charge. This is measured relative to the currently available energy capacity, and thus should always equal stateOfEnergyProjection divided by energyCapacityAvailable.

stateOfEnergyProjection: The projected state of energy of the virtual asset, based on its initial/current state of charge and schedule in kWh, e.g. 8000.0.

stateOfEnergy: The actual state of energy of the virtual asset, in kWh, e.g. 8000.0.

stateOfEnergyBoundsUpper: The allowed upper boundary of the state of energy of the virtual asset in kWh, e.g. 7200.0 if the virtual-asset is not allowed to be charged beyond 7200 kWh. This will equal stateOfChargeBoundsUpper multiplied by availableEnergyCapacity.

stateOfEnergyBoundsLower: The allowed lower boundary of the state of energy of the virtual asset in kWh, e.g. 800.0 if the virtual-asset is not allowed to discharged below 800 kWh. This will equal stateOfChargeBoundsLower multiplied by availableEnergyCapacity.

stateOfCharge: The state of energy of the virtual-asset as a fraction of available energy capacity energyCapacityAvailable as a ratio, e.g. 0.10 for a virtual-asset with 1000 kWh of available capacity at a state of energy of 100 kWh.

frozenEnergy: The frozen energy of the virtual asset in kWh, e.g. 500.0. This is energy that is not dispatchable due to an unavailability and is expected to be restored upon the end of that unavailability.

frozenEnergyProjection: The projected frozen energy of the virtual asset in kWh, e.g. 500.0.

energyCharged: The sum total of charged energy of the virtual asset in kWh, e.g. 100.0.

energyDischarged: The sum total of discharged energy of the virtual asset in kWh, e.g. 100.0.

afrrPosCapacityAvailable: The maximum available discharge power which can be bid into positive aFRR market products in kW, e.g. 7000.0. This value may be reduced during periods of unavailability.

afrrPosCapacityRated: The maximum rated discharge power which can be bid into positive aFRR market products in kW, e.g. 7000.0. This value remains unchanged during periods of unavailability.

afrrNegCapacityAvailable: The maximum available charge power which can be bid into negative aFRR market products in kW, e.g. 7000.0. This value may be reduced during periods of unavailability.

afrrNegCapacityRated: The maximum rated charge power which can be bid into negative aFRR market products in kW, e.g. 7000.0. This value remains unchanged during periods of unavailability.

afrrActivation: The sum total of activated positive/discharge and negative/charge power delivered by the virtual asset in the aFRR ancillary market in kW, e.g. 2000.0.

afrrPosActivation: The sum total of activated positive/discharge power delivered by the virtual asset in the aFRR ancillary market in kW, e.g. 3000.0.

afrrNegActivation: The sum total of activated negative/charge power delivered by the virtual asset in the aFRR ancillary market in kW, e.g. -1000.0.

fcrCapacityAvailable: The maximum available power capacity which can be bid into FCR market products in kW, e.g. 7000.0. This value may be reduced during periods of unavailability.

fcrCapacityRated: The maximum rated power capacity which can be bid into FCR market products in kW, e.g. 7000.0. This value remains unchanged during periods of unavailability.

fcrActivation: The sum total of activated power delivered by the virtual asset in the FCR ancillary market in kW, e.g. 1000.0.

maxTotalAncillaryCapacityChargeAvailable: The maximum total sum of available charge (negative) power capacity that can be bid across markets in kW, e.g. 8000.0. This includes all bids with a negative bid direction (FCR and aFRR Neg). This value may be reduced during periods of unavailability.

maxTotalAncillaryCapacityChargeRated: The maximum total sum of rated charge (negative) power capacity that can be bid across markets in kW, e.g. 10000.0. This includes all bids with a negative bid direction (FCR and aFRR Neg). This value remains unchanged during periods of unavailability.

maxTotalAncillaryCapacityDischargeAvailable: The maximum total sum of available discharge (positive) power capacity that can be bid across markets in kW, e.g. 8000.0. This includes all bids with a positive bid direction (FCR and aFRR Pos). This value may be reduced during periods of unavailability.

maxTotalAncillaryCapacityDischargeRated: The maximum total sum of rated discharge (positive) power capacity that can be bid across markets in kW, e.g. 10000.0. This includes all bids with a positive bid direction (FCR and aFRR Pos). This value remains unchanged during periods of unavailability.

fcrCommitment: The committed FCR capacity of the virtual asset for the latest delivery period in kW, e.g. 5000.0. Before the FCR auction results are released this reflects the total power capacity bid into FCR; once the auction clears it reflects the active commitment that has to be delivered. This value may be reduced during periods of unavailability.

afrrPosCommitment: The committed aFRR Pos discharge capacity of the virtual asset for the latest delivery period in kW, e.g. 5000.0. Before the aFRR auction results are released this reflects the total power capacity bid into aFRR Pos; once the auction clears it reflects the active commitment that has to be delivered. This value may be reduced during periods of unavailability.

afrrNegCommitment: The committed aFRR Neg (charge) capacity of the virtual asset for the latest delivery period in kW, e.g. 5000.0. Before the aFRR auction results are released this reflects the total power capacity bid into aFRR Neg; once the auction clears it reflects the active commitment that has to be delivered. This value may be reduced during periods of unavailability.

wholesalePowerCapacityChargeAvailable: The charge power capacity of the virtual asset which is available for wholesale trading in kW, e.g. 5000.0. Reduced by pending and accepted FCR and aFRR Neg ancillary commitments. This value may change during periods of unavailability.

wholesalePowerCapacityDischargeAvailable: The discharge power capacity of the virtual asset which is available for wholesale trading in kW, e.g. 5000.0. Reduced by pending and accepted FCR and aFRR Pos ancillary commitments. This value may change during periods of unavailability.

marketableCapacityAFRRPos: DEPRECATED. Please use the new category name instead: afrrPosCapacityAvailable.

marketableCapacityAFRRNeg: DEPRECATED. Please use the new category name instead: afrrNegCapacityAvailable.

marketableCapacityFCR: DEPRECATED. Please use the new category name instead: fcrCapacityAvailable.

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

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 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": {
    "dischargeEfficiency": {
      "metaData": {
        "unit": "ratio"
      },
      "dataPoints": [
        {
          "timestamp": "2025-07-11T22:00:00Z",
          "value": 0.95
        }
      ]
    },
    "marketableCapacityAFRRPos": {
      "metaData": {
        "unit": "kW"
      },
      "dataPoints": [
        {
          "timestamp": "2025-07-11T22:00:00Z",
          "value": 1000
        }
      ]
    },
    "marketableCapacityFCR": {
      "metaData": {
        "unit": "kW"
      },
      "dataPoints": [
        {
          "timestamp": "2025-07-11T22:00:00Z",
          "value": 1000
        }
      ]
    }
  }
}

GET

organisations

{organisationID}

virtual-assets

{virtualAssetID}

operational

latest

Gets the most recent operational data values for a virtual-asset.

curl --request GET \
  --url https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/operational/latest \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "data": {}
}

Headers

Authorization

string

default:Bearer <access token value>

required

Access token

Path Parameters

organisationID

string

required

Organisation ID

virtualAssetID

string

required

Virtual Asset ID

Query Parameters

Body

application/json

The body is of type object.

Response

data

object

required

Hide child attributes

data.{key}

object

Hide child attributes

data.{key}.dataPoints

object[]

required

Hide child attributes

data.{key}.dataPoints.timestamp

string

required

Example:

"2020-01-01T00:00:00+00:00"

data.{key}.dataPoints.value

number

required

Example:

100

data.{key}.metaData

object

required

Hide child attributes

data.{key}.metaData.unit

enum<string>

required

Available options:

PCT,

KW,

KWH,

KW/S,

AMP,

V,

C,

HZ,

WH,

W,

RATIO,

EFC,

EUR,

GC02EQKWH

Example:

"kW"

Last modified on June 30, 2026

Gets a selection of operational data of a virtual-asset as a timeseries.Get the projected state of charge of a virtual asset.

⌘I