# terralayr

## Docs

- [BESS Academy](https://docs.trlyr.com/BESS-academy/introduction.md): A self-paced learning path covering grid-scale Battery Energy Storage Systems, the German energy market, and how BESS assets are built, operated, and commercialised.
- [The Role of BESS in Germany's Energy Transition](https://docs.trlyr.com/BESS-academy/module-1/bess-energy-transition.md): See how battery storage fits into Germany's strategic shift towards a greener, more modern energy system.
- [Germany's Grid: An Overview](https://docs.trlyr.com/BESS-academy/module-1/germanys-grid.md): Understand the fundamental concept of an electricity grid and its vital need for constant balance between supply and demand.
- [Understanding Redispatch: Local Grid Traffic Jams](https://docs.trlyr.com/BESS-academy/module-1/redispatch.md): Learn how congestion on local grid sections requires special management, even when the overall national grid is balanced.
- [The Rise of Renewables & Grid Instability](https://docs.trlyr.com/BESS-academy/module-1/renewables-and-instability.md): Discover how renewable energy sources challenge grid stability and introduce the core problem that BESS is designed to solve.
- [What is a Battery Energy Storage System (BESS)?](https://docs.trlyr.com/BESS-academy/module-1/what-is-bess.md): A clear definition of grid-scale batteries, how they operate, and why their flexibility makes them essential for a modern electricity grid.
- [Talking to the Grid: BESS Communication Interfaces](https://docs.trlyr.com/BESS-academy/module-2/bess-communication.md): Understand how battery sites communicate with TSOs, DSOs, and market operators through the Gateway and its three primary interfaces.
- [A Tour of a BESS Site: Main Components](https://docs.trlyr.com/BESS-academy/module-2/bess-components.md): Explore the essential physical parts of a grid-scale battery site and understand what each one does.
- [How a BESS Works: Charge, Discharge & Ramp Rates](https://docs.trlyr.com/BESS-academy/module-2/how-bess-works.md): Learn the basics of battery operation — charging, discharging, and standby — and understand the grid constraints that govern how quickly power can change.
- [Ancillary Services Prequalification: Full Market Access](https://docs.trlyr.com/BESS-academy/module-3/ancillary-prequalification.md): Understand the rigorous testing and certification process required for BESS to participate in Germany's grid stability markets.
- [Battery Degradation: The Natural Aging Process](https://docs.trlyr.com/BESS-academy/module-3/battery-degradation.md): Learn how battery capacity naturally reduces over time, the factors that accelerate degradation, and why managing it is critical for long-term profitability.
- [Battery Warranties: Protecting Your Investment](https://docs.trlyr.com/BESS-academy/module-3/battery-warranties.md): Discover how warranties provide guarantees on battery performance and how they relate to usage limits and degradation management.
- [Construction & Commissioning: From Build to Go-Live](https://docs.trlyr.com/BESS-academy/module-3/construction-commissioning.md): Discover the physical construction process, grid connection, initial testing, and the crucial Commercial Operation Date (COD) milestone.
- [The Role of EPC Providers: Building the Asset](https://docs.trlyr.com/BESS-academy/module-3/epc-providers.md): Learn about Engineering, Procurement, and Construction companies and their role in bringing a BESS site to life.
- [Financing the Asset: Costs & Long-Term Returns](https://docs.trlyr.com/BESS-academy/module-3/financing.md): Understand the significant investment required to build and run a BESS, and why stable, long-term revenue streams are essential for investors.
- [Introduction to the BESS Project Lifecycle](https://docs.trlyr.com/BESS-academy/module-3/lifecycle-intro.md): Get an overview of the entire journey a grid-scale battery asset takes, from initial concept through to its eventual retirement.
- [Ongoing Operations & Maintenance (O&M): Keeping It Running](https://docs.trlyr.com/BESS-academy/module-3/operations-maintenance.md): Explore the day-to-day management of a BESS, including monitoring, servicing, unavailability reporting, and the critical role of O&M providers.
- [Project Origination & Planning: The Blueprint](https://docs.trlyr.com/BESS-academy/module-3/project-origination.md): Understand the crucial early steps — site selection, feasibility studies, and initial permitting — that lay the groundwork for a BESS project.
- [Repowering & End of Life: Future-Proofing and Retirement](https://docs.trlyr.com/BESS-academy/module-3/repowering-end-of-life.md): Understand how battery systems can be upgraded or replaced, and the key considerations for decommissioning and responsible recycling.
- [Ancillary Services: Keeping the Grid Stable (Part 1 — aFRR)](https://docs.trlyr.com/BESS-academy/module-4/ancillary-afrr.md): Explore automatic Frequency Restoration Reserve (aFRR) and its function in correcting unexpected imbalances in the electricity grid.
- [Ancillary Services: Keeping the Grid Stable (Part 2 — FCR)](https://docs.trlyr.com/BESS-academy/module-4/ancillary-fcr.md): Learn about Frequency Containment Reserve (FCR) and its role in providing instant, automatic grid balancing on a sub-second basis.
- [The Ancillary Services Pool: A Key Enabler](https://docs.trlyr.com/BESS-academy/module-4/ancillary-services-pool.md): Understand the specialised role of pool providers who aggregate assets and provide the direct, high-speed connections to TSOs required for ancillary service markets.
- [The Role of a Balancing Responsible Party (BRP)](https://docs.trlyr.com/BESS-academy/module-4/brp.md): Understand who is legally and financially accountable for grid balance and how the Nominations process allows BRPs to manage their imbalance exposure.
- [Roles in BESS Commercialisation: Optimisers & Investors](https://docs.trlyr.com/BESS-academy/module-4/commercialisation-roles.md): Understand the different key players in bringing a BESS asset to market, and the relationship between asset owners and optimisers.
- [Future Energy Markets: New Opportunities for BESS](https://docs.trlyr.com/BESS-academy/module-4/future-markets.md): Explore emerging market services and the potential for BESS to unlock new revenue streams as the grid continues to evolve.
- [Generating Revenue: How BESS Makes Money](https://docs.trlyr.com/BESS-academy/module-4/generating-revenue.md): A high-level overview of the ways grid-scale batteries earn revenue in electricity markets.
- [Understanding Imbalance: The Cost of Not Sticking to the Plan](https://docs.trlyr.com/BESS-academy/module-4/imbalance.md): Learn about the financial consequences of deviating from planned energy schedules and why the TSO enforces strict balancing obligations.
- [REMIT: Ensuring Market Integrity & Transparency](https://docs.trlyr.com/BESS-academy/module-4/remit.md): Learn about the regulations designed to prevent market manipulation and ensure fair, transparent trading in wholesale energy markets.
- [Wholesale Energy Markets: Trading Electricity](https://docs.trlyr.com/BESS-academy/module-4/wholesale-markets.md): Discover how BESS participates in day-ahead and intraday electricity markets to generate revenue from price differences.
- [Contracted Revenue: Stable Returns for Investors](https://docs.trlyr.com/BESS-academy/module-5/contracted-revenue.md): Learn how fixed payment agreements and the LAYR platform help reduce risk and provide predictable income for BESS asset owners.
- [Investment in BESS: The Challenge](https://docs.trlyr.com/BESS-academy/module-5/investment-challenge.md): Identify the inherent risks of investing in large-scale energy infrastructure and understand why predictable revenue is so critical for BESS asset owners.
- [Swap Contracts: Managing Market Risk](https://docs.trlyr.com/BESS-academy/module-5/swap-contracts.md): Discover how financial agreements can exchange variable market revenues for more predictable payments, and why this trade-off is valuable for BESS investors.
- [LAYR Academy](https://docs.trlyr.com/LAYR-academy/introduction.md): Learn how the LAYR platform works — from the barriers it breaks down to the modules that deliver it.
- [The BESS market: barriers to entry](https://docs.trlyr.com/LAYR-academy/module-1/bess-market-barriers.md): The challenges that make it difficult to enter or scale in the BESS market — for asset owners and optimisers alike.
- [terralayr's mission: minimising barriers, maximising opportunity](https://docs.trlyr.com/LAYR-academy/module-1/terralayr-mission.md): How terralayr's core offerings reduce barriers to entry across the BESS value chain.
- [LAYR's disaggregation power: unlocking new possibilities](https://docs.trlyr.com/LAYR-academy/module-2/disaggregation.md): How LAYR goes beyond the traditional VPP by combining aggregation with unique disaggregation capabilities.
- [Understanding the Virtual Power Plant (VPP)](https://docs.trlyr.com/LAYR-academy/module-2/virtual-power-plant.md): What a VPP is, how aggregation works, and why it matters for distributed energy resources.
- [Overview of LAYR modules](https://docs.trlyr.com/LAYR-academy/module-3/layr-modules.md): The building blocks of the LAYR platform — what each module does and who it serves.
- [The LAYR modular offering: plug-and-play flexibility](https://docs.trlyr.com/LAYR-academy/module-3/modular-offering.md): Why LAYR is structured as independent, combinable modules — and the strategic advantages this brings.
- [Get an auction by ID](https://docs.trlyr.com/auctions-api-reference/auctions/get-an-auction-by-id.md): Returns a single auction your organisation participates in, including the auctioned virtual-asset parameters, your latest bid, and a status (`NOT_STARTED`, `RUNNING`, `WON`, `LOST`, `PENDING`, or `NO_BIDS_SUBMITTED`). If you won, the item includes the allocated virtual asset ID.
- [Health check](https://docs.trlyr.com/auctions-api-reference/auctions/health-check.md): Returns 200 when the auctioneer service is running.
- [List auctions](https://docs.trlyr.com/auctions-api-reference/auctions/list-auctions.md): Returns all auctions where your organisation is a registered participant. Each entry includes open times, auctioned asset parameters, your latest bid, and outcome status. Requires the `Read:auctions` permission.
- [List your organisation's bids](https://docs.trlyr.com/auctions-api-reference/bids/list-your-organisations-bids.md): Returns every bid your organisation has submitted for the auction, ordered chronologically. Each bid includes the EUR price and submission timestamp. Requires the `Read:bids` permission.
- [Submit a bid](https://docs.trlyr.com/auctions-api-reference/bids/submit-a-bid.md): Places a bid on a running auction for your organisation. The auction must be within its open interval, your organisation must be a participant, and the price must be in EUR (maximum €10,000,000). Multiple bids are allowed; your latest bid is used when determining the winner. Highest price wins; if p…
- [Authenticate with username and password](https://docs.trlyr.com/auth-api-reference/auth/authenticate-with-username-and-password.md): Returns an OAuth token set including an access token for subsequent API calls.
- [Health check](https://docs.trlyr.com/auth-api-reference/auth/health-check.md)
- [April 2, 2026](https://docs.trlyr.com/changelog/2026/april/april-02.md): Per-product rated capacity timeseries, frozen & liquid unavailability system preview, platform improvements, and bug fixes.
- [April 10, 2026](https://docs.trlyr.com/changelog/2026/april/april-10.md): aFRR activation data categories, cycling validation, and ramp rate transition announcement.
- [April 17, 2026](https://docs.trlyr.com/changelog/2026/april/april-17.md): Schedule power rounding now rounds down; ancillary asset creation enforces SoE boundary validation.
- [April 24, 2026](https://docs.trlyr.com/changelog/2026/april/april-24.md): Frozen and liquid unavailability system rolled out platform-wide.
- [June 5, 2026](https://docs.trlyr.com/changelog/2026/june/june-05.md): A new, simplified ancillary services suite: unified ancillary service endpoint, new operational data categories for ancillary commitments, available wholesale capacity, and cross-market validation.
- [June 12, 2026](https://docs.trlyr.com/changelog/2026/june/june-12.md): Multiple ancillary service bids per product are now supported end-to-end, with an improved view of accepted and rejected bids, plus infrastructure and security hardening for greater resilience and availability.
- [June 26, 2026](https://docs.trlyr.com/changelog/2026/june/june-26.md): New ancillary results and bids endpoints for physical assets, richer response data on the existing results endpoint, and updated graphs in the webapp.
- [March 27, 2026](https://docs.trlyr.com/changelog/2026/march/march-27.md): Cone of flexibility, new operational data categories for deliverable power and cycling.
- [May 1, 2026](https://docs.trlyr.com/changelog/2026/may/may-01.md): Deprecation notices for SoE/SoC endpoints and ramp-rated asset migration, OpenAPI v3.0, and bug fixes.
- [May 6, 2026](https://docs.trlyr.com/changelog/2026/may/may-06.md): Layr User Guide, BESS Academy, LAYR Academy, and interactive API reference.
- [May 8, 2026](https://docs.trlyr.com/changelog/2026/may/may-08.md): Launch of the official terralayr documentation site at docs.trlyr.com; product updates, guides, academies, and interactive API reference in one hub; unavailability and boundary handling fix.
- [May 15, 2026](https://docs.trlyr.com/changelog/2026/may/may-15.md): New `deliveryPeriodSetpoint` data category on block operational data for ramp-rated assets; fixes for aFRR block capacity reservations, schedule validation double-counting unavailabilities, and SoC timeseries when no energy measurement exists.
- [May 22, 2026](https://docs.trlyr.com/changelog/2026/may/may-22.md): 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.
- [Product Updates](https://docs.trlyr.com/changelog/index.md): Latest updates, improvements, and deprecation notices for the Layr platform.
- [Cycling Calculations for Assets with a Variable Energy Capacity ](https://docs.trlyr.com/layrUserGuide/deep-dives/cycling-calculations.md): How cycle limits and available energy discharges are calculated for assets with variable capacity.
- [Ramp Rates](https://docs.trlyr.com/layrUserGuide/deep-dives/ramp-rates.md)
- [Soft re-validation](https://docs.trlyr.com/layrUserGuide/deep-dives/soft-revalidation.md): A detailed reference for the soft re-validation logic applied to dispatch schedules at 7 minutes before delivery.
- [Ancillary services (block level)](https://docs.trlyr.com/layrUserGuide/features/ancillary-services-block-level.md): How to manage virtual assets in FCR and aFRR ancillary service markets on Layr at the block level.
- [Ancillary services (virtual asset level)](https://docs.trlyr.com/layrUserGuide/features/ancillary-services-virtual-asset-level.md): Implementation guide for participating in FCR and aFRR ancillary service markets at the virtual asset level on Layr.
- [Virtual Asset Scheduling Errors](https://docs.trlyr.com/layrUserGuide/features/scheduling-errors.md): How terralayr validates, corrects, and rejects virtual asset dispatch schedules.
- [Virtual asset unavailabilities](https://docs.trlyr.com/layrUserGuide/features/unavailabilities.md): How physical asset outages affect virtual batteries, and what you need to do.
- [Asset owner platform onboarding](https://docs.trlyr.com/layrUserGuide/getting-started/asset-owner-onboarding.md): An overview of the terralayr platform for asset owners: Connect, Control, and Ledger.
- [Designated optimiser onboarding](https://docs.trlyr.com/layrUserGuide/getting-started/do-onboarding.md): A quick-start guide for operating as a Designated Optimiser (DO) on Layr.
- [Virtual asset off-taker onboarding](https://docs.trlyr.com/layrUserGuide/getting-started/offtaker-onboarding.md): A quick-start guide for operating your virtual asset on Layr as an off-taker.
- [Virtual battery auction (vBA) onboarding](https://docs.trlyr.com/layrUserGuide/getting-started/vba-onboarding.md): A quick-start guide for participating in virtual battery auctions on Layr.
- [Glossary](https://docs.trlyr.com/layrUserGuide/glossary.md): Definitions of key terms used across the terralayr platform and documentation.
- [Introduction](https://docs.trlyr.com/layrUserGuide/introduction.md): The official home for Layr documentation — continuously maintained by the team that builds the platform.
- [Get detailed summed statistics with calculated energy values.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-detailed-summed-statistics-with-calculated-energy-values.md): Calculates aggregated statistics for monitoring data points within a time interval
- [Get distinct data point names for a physical asset.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-distinct-data-point-names-for-a-physical-asset.md): Retrieves a list of all distinct data point names available for a specific physical
- [Get monitoring data points aggregated to 1-minute intervals.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-monitoring-data-points-aggregated-to-1-minute-intervals.md): Retrieves monitoring data points aggregated to 1-minute intervals. Returns all
- [Get monitoring data points aggregated to 15-minute intervals.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-monitoring-data-points-aggregated-to-15-minute-intervals.md): Retrieves monitoring data points aggregated to 15-minute intervals. Returns all
- [Get monitoring data points aggregated to 5-minute intervals.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-monitoring-data-points-aggregated-to-5-minute-intervals.md): Retrieves monitoring data points aggregated to 5-minute intervals. Returns all
- [Get monitoring data points aggregated to daily intervals.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-monitoring-data-points-aggregated-to-daily-intervals.md): Retrieves monitoring data points aggregated to daily intervals. Returns all
- [Get monitoring data points aggregated to hourly intervals.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-monitoring-data-points-aggregated-to-hourly-intervals.md): Retrieves monitoring data points aggregated to hourly intervals. Returns all
- [Get monitoring data points with automatic interval selection.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-monitoring-data-points-with-automatic-interval-selection.md): Retrieves monitoring data points with automatic selection of the appropriate
- [Get raw monitoring data points for a physical asset.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-raw-monitoring-data-points-for-a-physical-asset.md): Retrieves raw monitoring data points for a specific physical asset within a time
- [Get raw summed statistics for monitoring data points.](https://docs.trlyr.com/monitoring-api-reference/monitoring/get-raw-summed-statistics-for-monitoring-data-points.md): Calculates aggregated statistics (sum, count, min, max) for monitoring data points
- [Get ancillary bids by delivery day](https://docs.trlyr.com/physical-assets-api-reference/ancillary/get-ancillary-bids-by-delivery-day.md)
- [Get ancillary bids by product keys](https://docs.trlyr.com/physical-assets-api-reference/ancillary/get-ancillary-bids-by-product-keys.md)
- [Get ancillary results by bid IDs](https://docs.trlyr.com/physical-assets-api-reference/ancillary/get-ancillary-results-by-bid-ids.md)
- [Get ancillary results by delivery day](https://docs.trlyr.com/physical-assets-api-reference/ancillary/get-ancillary-results-by-delivery-day.md)
- [Submit ancillary bids](https://docs.trlyr.com/physical-assets-api-reference/ancillary/submit-ancillary-bids.md)
- [Delete an EEX notification](https://docs.trlyr.com/physical-assets-api-reference/eex/delete-an-eex-notification.md)
- [Get an EEX notification by ID](https://docs.trlyr.com/physical-assets-api-reference/eex/get-an-eex-notification-by-id.md)
- [List EEX notifications for a physical asset](https://docs.trlyr.com/physical-assets-api-reference/eex/list-eex-notifications-for-a-physical-asset.md)
- [Submit an EEX notification](https://docs.trlyr.com/physical-assets-api-reference/eex/submit-an-eex-notification.md)
- [Update an EEX notification](https://docs.trlyr.com/physical-assets-api-reference/eex/update-an-eex-notification.md)
- [Health check](https://docs.trlyr.com/physical-assets-api-reference/health/health-check.md)
- [Create a logbook entry](https://docs.trlyr.com/physical-assets-api-reference/logbook/create-a-logbook-entry.md)
- [Delete a logbook entry](https://docs.trlyr.com/physical-assets-api-reference/logbook/delete-a-logbook-entry.md)
- [Get a logbook entry by ID](https://docs.trlyr.com/physical-assets-api-reference/logbook/get-a-logbook-entry-by-id.md)
- [List logbook entries for a physical asset](https://docs.trlyr.com/physical-assets-api-reference/logbook/list-logbook-entries-for-a-physical-asset.md)
- [Update a logbook entry](https://docs.trlyr.com/physical-assets-api-reference/logbook/update-a-logbook-entry.md)
- [Create metadata for a physical asset category](https://docs.trlyr.com/physical-assets-api-reference/metadata/create-metadata-for-a-physical-asset-category.md)
- [Delete metadata for a physical asset category](https://docs.trlyr.com/physical-assets-api-reference/metadata/delete-metadata-for-a-physical-asset-category.md)
- [Get metadata for a physical asset category](https://docs.trlyr.com/physical-assets-api-reference/metadata/get-metadata-for-a-physical-asset-category.md)
- [List all metadata for a physical asset](https://docs.trlyr.com/physical-assets-api-reference/metadata/list-all-metadata-for-a-physical-asset.md)
- [Update metadata for a physical asset category](https://docs.trlyr.com/physical-assets-api-reference/metadata/update-metadata-for-a-physical-asset-category.md)
- [Create a physical asset](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/create-a-physical-asset.md)
- [Create an unavailability](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/create-an-unavailability.md)
- [Delete an unavailability](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/delete-an-unavailability.md)
- [Get physical asset by ID](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/get-physical-asset-by-id.md)
- [Get unavailability by ID](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/get-unavailability-by-id.md)
- [List physical assets](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/list-physical-assets.md): Returns physical assets visible to the caller. Admins receive all assets; organisation users receive assets linked to their organisation.
- [List unavailabilities for a physical asset](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/list-unavailabilities-for-a-physical-asset.md)
- [Update a physical asset](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/update-a-physical-asset.md)
- [Update an unavailability](https://docs.trlyr.com/physical-assets-api-reference/physical-assets/update-an-unavailability.md)
- [Get schedule for a physical asset](https://docs.trlyr.com/physical-assets-api-reference/schedule/get-schedule-for-a-physical-asset.md)
- [Update schedule for a physical asset](https://docs.trlyr.com/physical-assets-api-reference/schedule/update-schedule-for-a-physical-asset.md)
- [Get aFRR capacity revenue for a virtual asset](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-afrr-capacity-revenue-for-a-virtual-asset.md): Returns aFRR capacity revenue buckets for the virtual asset between start and end (RFC3339 query parameters).
- [Get aFRR energy revenue for a virtual asset](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-afrr-energy-revenue-for-a-virtual-asset.md): Returns aFRR energy revenue buckets for the virtual asset between start and end (RFC3339 query parameters).
- [Get aggregated revenue data points for a fleet](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-aggregated-revenue-data-points-for-a-fleet.md): Returns aggregated revenue data points for the fleet. Use `/datapoints/15min`, `/datapoints/hourly`, or `/datapoints/daily` for other resolutions. Optional `datapoints` query parameter filters by category; see **Data point categories** in the API overview.
- [Get aggregated revenue data points for a physical asset](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-aggregated-revenue-data-points-for-a-physical-asset.md): Returns aggregated revenue data points for the physical asset. Use `/datapoints/15min`, `/datapoints/hourly`, or `/datapoints/daily` for other resolutions. Optional `datapoints` query parameter filters by category; see **Data point categories** in the API overview.
- [Get aggregated revenue data points for a portfolio](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-aggregated-revenue-data-points-for-a-portfolio.md): Returns aggregated revenue data points for the portfolio. Use `/datapoints/15min`, `/datapoints/hourly`, or `/datapoints/daily` for other resolutions. Optional `datapoints` query parameter filters by category; see **Data point categories** in the API overview.
- [Get aggregated revenue data points for a virtual asset](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-aggregated-revenue-data-points-for-a-virtual-asset.md): Returns aggregated revenue data points for the virtual asset. Use `/datapoints/15min`, `/datapoints/hourly`, or `/datapoints/daily` for other resolutions. Optional `datapoints` query parameter filters by category; see **Data point categories** in the API overview for the full list.
- [Get FCR revenue for a virtual asset](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-fcr-revenue-for-a-virtual-asset.md): Returns FCR capacity revenue buckets for the virtual asset between start and end (RFC3339 query parameters).
- [Get fleet for an organisation](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-fleet-for-an-organisation.md): Returns the fleet associated with the given organisation ID.
- [Get tolling revenue for a virtual asset](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-tolling-revenue-for-a-virtual-asset.md): Returns tolling revenue buckets for the virtual asset between start and end (RFC3339 query parameters).
- [Get virtual battery auction revenue for a virtual asset](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-virtual-battery-auction-revenue-for-a-virtual-asset.md): Returns virtual battery auction revenue buckets for the virtual asset between start and end (RFC3339 query parameters).
- [Get wholesale revenue for a virtual asset](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/get-wholesale-revenue-for-a-virtual-asset.md): Returns wholesale revenue buckets for the virtual asset between start and end (RFC3339 query parameters).
- [Health check](https://docs.trlyr.com/revenue-reporting-api-reference/revenue/health-check.md): Returns 200 when the revenue-reporting service is running.
- [terralayr API](https://docs.trlyr.com/trlyr-API/introduction.md): Build integrations with the terralayr platform — manage virtual assets, participate in auctions, report on revenue, and monitor physical assets.
- [Creates aFRR bids for a given virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/afrr/creates-afrr-bids-for-a-given-virtual-asset.md): # Creates aFRR bids for a virtual asset
- [Get aFRR bids for a given virtual asset, product and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/afrr/get-afrr-bids-for-a-given-virtual-asset-product-and-delivery-day.md): # Gets aFRR bids for a given virtual asset, product and delivery day
- [Get all aFRR bids for a given virtual asset and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/afrr/get-all-afrr-bids-for-a-given-virtual-asset-and-delivery-day.md): # Gets all aFRR bids for a given virtual asset and delivery day
- [Get all aFRR results for a given virtual asset and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/afrr/get-all-afrr-results-for-a-given-virtual-asset-and-delivery-day.md): # Gets aFRR results for a given virtual asset, product and delivery day
- [Gets aFRR results for a given virtual asset, product and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/afrr/gets-afrr-results-for-a-given-virtual-asset-product-and-delivery-day.md): # Gets aFRR results for a given virtual asset, product and delivery day.
- [Update aFRR bids for a single product and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/afrr/update-afrr-bids-for-a-single-product-and-delivery-day.md): # Updates an aFRR product bid for a virtual asset
- [Get all ancillary bids for a given virtual asset and interval.](https://docs.trlyr.com/virtual-assets-api-reference/ancillary/get-all-ancillary-bids-for-a-given-virtual-asset-and-interval.md): # Gets all ancillary bids for a given virtual asset and time interval
- [Get all ancillary results for a given virtual asset and interval.](https://docs.trlyr.com/virtual-assets-api-reference/ancillary/get-all-ancillary-results-for-a-given-virtual-asset-and-interval.md): # Gets all ancillary results for a given virtual asset and time interval
- [Post or update ancillary bids for a given virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/ancillary/post-or-update-ancillary-bids-for-a-given-virtual-asset.md): # Post or update ancillary bids for a virtual asset
- [Get a block.](https://docs.trlyr.com/virtual-assets-api-reference/blocks/get-a-block.md): Get a block.
- [Get all the blocks belonging to a virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/blocks/get-all-the-blocks-belonging-to-a-virtual-asset.md): Get all the blocks belonging to a virtual asset.
- [Gets a selection of operational data of a block as a timeseries.](https://docs.trlyr.com/virtual-assets-api-reference/blocks/gets-a-selection-of-operational-data-of-a-block-as-a-timeseries.md): Gets a selection of operational data of a block as a timeseries.
- [Gets the most recent operational data values for a block.](https://docs.trlyr.com/virtual-assets-api-reference/blocks/gets-the-most-recent-operational-data-values-for-a-block.md): Gets the most recent operational data values for a block.
- [Update the schedule of a block](https://docs.trlyr.com/virtual-assets-api-reference/blocks/update-the-schedule-of-a-block.md): Update the schedule of a block.
- [Create FCR bids for a given virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/fcr/create-fcr-bids-for-a-given-virtual-asset.md): # Creates fCR bids for a  virtual asset
- [Get all FCR bids for a given virtual asset and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/fcr/get-all-fcr-bids-for-a-given-virtual-asset-and-delivery-day.md): # Gets all FCR bids for a given virtual asset and delivery day
- [Get all FCR results for a given virtual asset and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/fcr/get-all-fcr-results-for-a-given-virtual-asset-and-delivery-day.md): # Gets fCR results for a given virtual asset, product and delivery day
- [Get FCR bids for a given virtual asset, product and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/fcr/get-fcr-bids-for-a-given-virtual-asset-product-and-delivery-day.md): # Gets FCR bids for a given virtual asset, product and delivery day.
- [Gets FCR results for a given virtual asset, product and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/fcr/gets-fcr-results-for-a-given-virtual-asset-product-and-delivery-day.md): # Gets fCR results for a given virtual asset, product and delivery day.
- [Update FCR bids for a single product and delivery day.](https://docs.trlyr.com/virtual-assets-api-reference/fcr/update-fcr-bids-for-a-single-product-and-delivery-day.md): # Updates a fCR product bid for a virtual asset
- [Get a virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-a-virtual-asset.md): Get a virtual asset.
- [Get all the virtual assets belonging to an organisation.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-all-the-virtual-assets-belonging-to-an-organisation.md): Get all the virtual assets belonging to an organisation.
- [Get the latest state of charge of a virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-the-latest-state-of-charge-of-a-virtual-asset.md): DEPRECATED: This endpoint is deprecated and will be removed in a future version. To retrieve state of charge values, use the operational endpoint `GET /organisations/{organisationID}/virtual-assets/{virtualAssetID}/operational`.
- [Get the latest state of energy of a virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-the-latest-state-of-energy-of-a-virtual-asset.md): DEPRECATED: This endpoint is deprecated and will be removed in a future version. To retrieve state of energy values, use the operational endpoint `GET /organisations/{organisationID}/virtual-assets/{virtualAssetID}/operational`.
- [Get the most recent usable energy-capacity of a virtual-asset.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-the-most-recent-usable-energy-capacity-of-a-virtual-asset.md): Get the most recent usable energy-capacity of a virtual-asset.
- [Get the projected state of charge of a virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-the-projected-state-of-charge-of-a-virtual-asset.md): DEPRECATED: This endpoint is deprecated and will be removed in a future version. To retrieve state of charge values, use the operational endpoint `GET /organisations/{organisationID}/virtual-assets/{virtualAssetID}/operational`.
- [Get the projected state of charge of a virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-the-projected-state-of-charge-of-a-virtual-asset-1.md): DEPRECATED: This endpoint is deprecated and will be removed in a future version. To retrieve state of charge values, use the operational endpoint `GET /organisations/{organisationID}/virtual-assets/{virtualAssetID}/operational`.
- [Get the projected state of energy of a virtual asset.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-the-projected-state-of-energy-of-a-virtual-asset.md): DEPRECATED: This endpoint is deprecated and will be removed in a future version. To retrieve state of energy values, use the operational endpoint `GET /organisations/{organisationID}/virtual-assets/{virtualAssetID}/operational`.
- [Get the usable energy-capacity of a virtual-asset as a timeseries.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/get-the-usable-energy-capacity-of-a-virtual-asset-as-a-timeseries.md): Get the usable energy-capacity of a virtual-asset as a timeseries.
- [Gets a selection of operational data of a virtual-asset as a timeseries.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/gets-a-selection-of-operational-data-of-a-virtual-asset-as-a-timeseries.md): Gets a selection of operational data of a virtual-asset as a timeseries.
- [Gets schedule adjustments for a virtual asset within a time range.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/gets-schedule-adjustments-for-a-virtual-asset-within-a-time-range.md): Gets a list of schedule adjustments for a virtual asset within a specified time range.
- [Gets the most recent operational data values for a virtual-asset.](https://docs.trlyr.com/virtual-assets-api-reference/virtual-assets/gets-the-most-recent-operational-data-values-for-a-virtual-asset.md): Gets the most recent operational data values for a virtual-asset.

## OpenAPI Specs

- [doc](https://api.sandbox.trlyr.com/docs/doc.json)
- [monitoring](https://docs.trlyr.com/trlyr-API/monitoring.json)
- [terralayrSandbox-oas3](https://docs.trlyr.com/trlyr-API/terralayrSandbox-oas3.yaml)
- [openapi](https://docs.trlyr.com/api-reference/openapi.json)