> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trlyr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# May 22, 2026

> New ancillary bids and results endpoints; unavailability and SoE improvements; formal end-of-life of legacy SoC/SoE endpoints and deprecation of legacy operational data category names.

### New features

* We have improved the state of energy calculation during unavailabilities. The SoE is now bounded by the asset's available capacity rather than its rated (nameplate) capacity. During periods of partial unavailability, the State of Charge (SoC) values returned by the platform will now always be bound to \[0,1]. More details: [Virtual asset unavailabilities](/layrUserGuide/features/unavailabilities).
* **Ancillary bids and results** — We have added two endpoints to retrieve ancillary market data for a virtual asset over a time interval (use `start` and `end` query parameters in RFC3339 format):
  * `/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/bids` — [Get all ancillary bids for a given virtual asset and interval](/virtual-assets-api-reference/ancillary/get-all-ancillary-bids-for-a-given-virtual-asset-and-interval)
  * `/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/results` — [Get all ancillary results for a given virtual asset and interval](/virtual-assets-api-reference/ancillary/get-all-ancillary-results-for-a-given-virtual-asset-and-interval)

### Bugfixes

* A bug that was causing wholesale blocks to be incorrectly curtailed during periods of partial unavailability on assets with successful ancillary services bids has been fixed.

### Deprecation Notices

**state-of-energy and state-of-charge endpoints**

The legacy state-of-charge and state-of-energy endpoints are now formally at their end of life. The endpoints continue to function, but customers should migrate to the operational data endpoint, which provides equivalent data alongside richer data categories.

* `/organisations/{organisationID}/virtual-assets/{virtualAssetID}/state-of-charge` (and `/projected`, `/latest`)
* `/organisations/{organisationID}/virtual-assets/{virtualAssetID}/state-of-energy` (and `/projected`, `/latest`)

**Marketable Capacity Data Categories**

The operational data category names `marketableCapacityAFRRPos`, `marketableCapacityAFRRNeg`, and `marketableCapacityFCR` are being deprecated. Please use `afrrPosCapacityAvailable`, `afrrNegCapacityAvailable`, and `fcrCapacityAvailable` instead.