GridSense Docs
Application API

Get current installation energy flow

Requests go to the API through the GridSense docs server. The playground remembers your key in this browser so you can use it on all endpoint pages. Clear it when you finish, especially on a shared computer.

GET
/getInstallationCurrentEnergyFlow

Query

Returns aggregated energy flow for an accessible installation using the same calculation as the app API. First call getInstallations and enter a returned id as installationId. Only online devices contribute; data is null when none are online. All power fields are in W. gridPower is positive for import and negative for export, opposite to raw grid-meter powerAc. batteryPower is positive for charging and negative for discharging. housePower excludes EV charger and boiler consumption. See the power direction guide for calculation details and missing-reading caveats.

Api-Key<token>

Paste your full gsak_ application API key.

In: header

Query Parameters

installationId*integer

Integer installation ID returned by getInstallations. Replace the fictional example with an ID your application can access. Fractions are rejected.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/getInstallationCurrentEnergyFlow?installationId=42"

{  "valid": true,  "installationId": 42,  "data": {    "inverterPower": 4200,    "solarPower": 5000,    "batteryPower": 800,    "batterySoe": 65,    "gridPower": -1200,    "housePower": 2000,    "evChargerPower": 600,    "boilerPower": 400,    "lastUpdated": "2026-09-09T14:05:11+02:00"  }}