Skip to main content

​
Solar Inverter State

Solar inverter state parameters provide real-time production data, battery status, household consumption, and energy metrics. These fields are read-only and automatically updated from the manufacturer’s API.
State data refresh frequency depends on the manufacturer’s API. Most values update every 5-15 minutes.

​
Solar Production

​
current_solar_production_w
integer
Current solar power production in Watts.Returns 0 during nighttime or cloudy conditions.Example: 6250
​
solar_surplus_w
integer
Excess solar power available after meeting household demand, in Watts.Positive values indicate surplus power available for battery charging or grid export.Example: 4500
​
production_last_day_kwh
float
Solar energy production for the previous day in kWh.Example: 32.5
​
production_last_week_kwh
float
Solar energy production for the previous week in kWh.Example: 120.1
​
production_last_month_kwh
float
Solar energy production for the previous month in kWh.Example: 451.3
​
production_last_updated_utc
datetime
Timestamp when production data was last calculated.Example: 2023-03-22T13:54:34.000Z

​
Household Consumption

​
household_consumption_w
integer
Current total power consumption of the household in Watts.Includes all electrical loads in the building.Example: 950

​
Battery Status

​
battery_charge_level_percent
integer
Current battery charge level in percent.Returns null or 0 if no battery is connected.Example: 85Range: 0-100
​
battery_charge_discharge_power_w
integer
Current battery power flow in Watts.Positive values: Battery is charging Negative values: Battery is dischargingExample: -755 (discharging at 755W)
​
charge_state_last_updated
datetime
Timestamp when the battery and inverter state was last updated from the manufacturer’s API.Use this to determine data freshness.Example: 2023-03-22T13:54:34.000Z

​
Usage Examples

​
Get Inverter State

curl -X GET \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Accept: application/json'

​
Understanding Power Flows

Scenario: current_solar_production_w: 8000, household_consumption_w: 1500
  • 1500W used directly in home
  • 6500W surplus available
  • Battery charges if below max charge limit
  • Remaining surplus exported to grid
Battery: Charging at maximum rate Grid: Exporting excess power

​
Best Practices

  • Poll inverter state every 5-10 minutes during daylight hours
  • Reduce polling to 15-30 minutes during nighttime
  • Check charge_state_last_updated to avoid unnecessary calls
  • Display last update timestamp for transparency
  • Show current production prominently during daylight
  • Display daily/weekly/monthly production trends
  • Calculate and show self-consumption percentage
  • Highlight peak production times
  • Display battery level with charge/discharge status
  • Show power flow direction (charging/discharging)
  • Alert on unusual battery behavior
  • Track cycling patterns for health monitoring
  • Visualize power flows between solar, battery, home, and grid
  • Calculate and display self-consumption rate
  • Show grid import/export in real-time
  • Provide historical energy flow analysis

Inverter Attributes

Writable parameters and configuration

Dashboard Integration

Building end-user dashboards

Managing Buildings

Multi-device coordination

Energy Contracts

Energy pricing parameters