> ## 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. # Get the projected state of charge of a virtual asset. > 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 as a timeseries. Returns a timeseries of the projected state of charge of a virtual asset as JSON. This timeseries is right-aligned relative to the 15-minute power trading windows. e.g. `"time": "2023-11-11T14:30:00Z"` and `"stateOfChargePercentage": 23.5` mean that the virtual asset is projected to reach a state of charge of 23.5% at the end of the 15-minute window starting at 2023-11-11T14:30:00Z, i.e. at 2023-11-11T14:45:00Z. The timeseries will cover the parsed start and end times. If none are provided, then the timeseries will cover a window of 72 hours, with up to 3 days in the past and 4 days into the future. Projected values are only guaranteed for up to 48h into the future. ## OpenAPI ````yaml https://api.sandbox.trlyr.com/docs/doc.json get /organisations/{organisationID}/virtual-assets/{virtualAssetID}/state-of-charge openapi: 3.1.0 info: description: > This API allows clients to manage virtual-assets and blocks on the terralayr system. A virtual asset is a virtual battery, it has static parameters that dictate how much power it can import / export, how much energy it can store, and how efficiently it charges / discharges. It also has a state of charge which changes as the virtual asset exports and imports power. A block represents a slice of the power capacity of a virtual asset over time, and has a schedule which can be updated to control what the virtual-asset will do. Virtual assets should be kept balanced: you should manage the schedule such that the such that state of charge at the end of its lifetime is 50%. It is possible to submit schedules that do not end at 50%, but the response will include information about how much imbalance is left. ### Authorization All the underneath requests require a Bearer-type `Authorization` Header i.e. in the form : `Authorization: Bearer `. To retrieve a valid token you must log in to our system using a password-username authentication as follows: ``` POST https://api.sandbox.trlyr.com/auth/public/authenticate ``` with the following JSON body: ``` { "username": "YOUR_USERNAME", "password": "YOUR_PASSWORD" } ``` Your username and password are the ones you created after receiving an invitation to join your organisation. You should receive a JSON response body from which you can extract your token under `access_token`. If you have any questions, don't hesitate to contact our account manager at the following address: support@trlyr.com. title: terralayr API version: 1.11.3 servers: - description: Production API url: https://api.trlyr.com - description: Sandbox API url: https://api.sandbox.trlyr.com security: [] tags: - name: virtual-assets - name: afrr - name: fcr - name: ancillary - name: blocks externalDocs: description: '' url: '' paths: /organisations/{organisationID}/virtual-assets/{virtualAssetID}/state-of-charge: get: tags: - virtual-assets summary: Get the projected state of charge of a virtual asset. description: >- 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 as a timeseries. Returns a timeseries of the projected state of charge of a virtual asset as JSON. This timeseries is right-aligned relative to the 15-minute power trading windows. e.g. `"time": "2023-11-11T14:30:00Z"` and `"stateOfChargePercentage": 23.5` mean that the virtual asset is projected to reach a state of charge of 23.5% at the end of the 15-minute window starting at 2023-11-11T14:30:00Z, i.e. at 2023-11-11T14:45:00Z. The timeseries will cover the parsed start and end times. If none are provided, then the timeseries will cover a window of 72 hours, with up to 3 days in the past and 4 days into the future. Projected values are only guaranteed for up to 48h into the future. parameters: - description: Access token in: header name: Authorization required: true schema: default: Bearer type: string - description: Organisation ID in: path name: organisationID required: true schema: type: string - description: Virtual Asset ID in: path name: virtualAssetID required: true schema: type: string - description: Query start time in: query name: start required: true schema: type: string - description: Query end time in: query name: end required: true schema: type: string requestBody: content: application/json: schema: type: object responses: '200': content: application/json: schema: $ref: '#/components/schemas/deprecatedStateOfChargeProjection' description: OK '400': description: Bad Request '401': description: Unauthorized '500': description: Internal Server Error deprecated: true components: schemas: deprecatedStateOfChargeProjection: properties: stateOfChargeProfile: items: $ref: '#/components/schemas/deprecatedStateOfChargePoint' type: array uniqueItems: false required: - stateOfChargeProfile type: object deprecatedStateOfChargePoint: properties: stateOfChargePercentage: example: 50 type: number time: example: '2023-11-11T14:30:00Z' format: dateTime type: string required: - stateOfChargePercentage - time type: object ````