Skip to main content

Battery management

The platform allows interacting with battery systems linked to a supply point through the Connect API.

important

Battery information (e.g. capacity, SOC history) is available for all users, but battery control actions (such as charging or discharging commands) are only available for users who have connected their system and granted permission via Huawei OAuth integration. We are actively working to support additional inverters in the near future.

What you can do via API​

Through the API, you can:

  • Monitor battery power in real time, including current charging/discharging power (kW) and historical data over specified time ranges
  • Access static battery information, such as total capacity (kWh) and maximum charging/discharging power (kW)
  • Retrieve battery SOC within a defined time range, enabling historical visualization and monitoring
  • Program battery operations, by sending scheduled actions specifying time and target SOC. Actions execute automatically and end when target is reached or another action starts

This enables remote battery control for energy optimization, charging during low-tariff periods, discharging during peak-price hours, or enhancing solar self-consumption.

API Workflow​

The following diagram shows the complete workflow for battery management via API:

Example bodies for use cases​

Night Charge​

{
  "actions": [{"date": "2025-10-14T01:00:00.000Z", "action": "CHARGE", "targetSOC": 80, "dispatchTimeMins": 300}]
}

Peak Discharge​

{
  "actions": [{"date": "2025-10-14T18:00:00.000Z", "action": "DISCHARGE", "powerKWDispatch": 3}]
}

Solar Optimization​

{
  "actions": [
    {"date": "2025-10-14T08:00:00.000Z", "action": "CHARGE", "targetSOC": 100},
    {"date": "2025-10-14T18:00:00.000Z", "action": "DISCHARGE", "targetSOC": 20},
    {"date": "2025-10-14T22:00:00.000Z", "action": "CHARGE"}
  ]
}

Full Day Schedule​

{
  "actions": [
    {"date": "2025-10-14T01:00:00.000Z", "action": "CHARGE", "targetSOC": 100, "dispatchTimeMins": 300},
    {"date": "2025-10-14T08:00:00.000Z", "action": "PAUSE"},
    {"date": "2025-10-14T12:00:00.000Z", "action": "CHARGE"},
    {"date": "2025-10-14T18:00:00.000Z", "action": "DISCHARGE", "targetSOC": 30, "powerKWDispatch": 3}
  ]
}

Available endpoints​

getTenantEquipments

getStorageEquipment

getStorageEquipmentSoc

scheduleStorageEquipmentAction