Skip to content

HomeBatteryStatusLog

Records the state of a home battery at a particular point in time.

urlstring, (uri)
Example:"https://api.ev.energy/v2/home_batteries/hoba01J5DCXX8DMJDJYGVR1DW4J7AA/status_logs/2024-04-17T09:39:45.984584Z/"
sampled_atstring, (date-time)
home_batteryHomeBattery (object) or string
One of:

A resource that represents a single, physical home battery.

capacity_watt_hoursinteger or null

The total capacity of the battery in Wh.

Example:13500
state_of_charge_percentageinteger or null

Remaining battery charge level as a whole percentage (0-100).

Example:82
charge_rate_wattsinteger or null

Current charge rate in W. A positive value indicates charging.

Example:2200
discharge_limit_percentageinteger or null

Minimum reserve charge level as a whole percentage (0-100).

Example:20
statusstringread-only

Derived operating state of the battery.

Enum:"CHARGING""DISCHARGING""IDLE""FAULT""UNKNOWN"
Example:"CHARGING"
operation_modestringread-only

Current operation mode of the battery.

Enum:"EXPORT_FOCUS""IMPORT_FOCUS""TIME_OF_USE""SELF_RELIANCE""IDLE""UNKNOWN"
Example:"SELF_RELIANCE"
{ "url": "https://api.ev.energy/v2/home_batteries/hoba01J5DCXX8DMJDJYGVR1DW4J7AA/status_logs/2024-04-17T09:39:45.984584Z/", "sampled_at": "2019-08-24T14:15:22Z", "home_battery": { "id": "hoba01J5DCXX8DMJDJYGVR1DW4J7AA", "url": "https://api.ev.energy/v2/home_batteries/hoba01J5DCXX8DMJDJYGVR1DW4J7AA", "model": "https://api.ev.energy/v2/home_battery_models/bmod7XL7Q5294J6TUZARBQT2D1EOHY", "user": "https://api.ev.energy/v2/users/user01HN2NJ9NMRZBXT1H6FT9N7735", "created_at": "2024-03-15T14:22:33.123456Z", "latest_status_log": {} }, "capacity_watt_hours": 13500, "state_of_charge_percentage": 82, "charge_rate_watts": 2200, "discharge_limit_percentage": 20, "status": "CHARGING", "operation_mode": "SELF_RELIANCE" }