Skip to main content

​
Heat Pump State

Heat pump state parameters provide real-time sensor readings and current device status. 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.

​
Operational Status

​
current_power_consumption_w
integer
Current power consumption in Watts.Example: 2341
​
current_mode
enum
The optimization mode Podero is running the heat pump at right now. This reflects the actual real-time operation and may vary from optimization_level as the system responds to spot prices. Only meaningful when is_smart_optimization_active is true.Options: min, low, mid, maxExample: mid
​
current_state_last_updated_at
datetime
Timestamp when the device state was last updated from the manufacturer’s API.Use this to determine data freshness.Example: 2023-03-22T13:54:34.000Z

​
Temperature Readings

​
outdoor_temperature
float
Current outdoor temperature in °C measured by the heat pump.Example: 9.3
​
indoor_actual_temperature
float
Current indoor temperature in °C (if indoor sensor is available).May be null if the device doesn’t have an indoor temperature sensor.Example: 21.2
​
indoor_target_temperature
float
Target indoor temperature in °C requested by the heating system.May be null if not reported by the device.Example: 22.0
​
indoor_target_temperature_offset
float
Offset applied to the indoor target temperature in °C. Podero uses this to steer heating up or down relative to the user’s base target.Example: 1.5
​
optimization_level
enum
The configured optimization aggressiveness for this heat pump — the ceiling Podero will operate at.Options: Low, Mid, MaxExample: Mid
​
inlet_temperature
float
Temperature of the heating circuit water entering the heat pump in °C.Example: 35.4
​
outlet_temperature
float
Temperature of the heating circuit water leaving the heat pump in °C.Example: 42.1
​
dhw_temperature
float
Current temperature of domestic hot water in °C.Example: 51.1
​
dhw_standard_temperature
float
Domestic hot water setpoint temperature in °C as reported by the device.Example: 48.0

​
Usage Examples

​
Get Device State

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

​
Best Practices

  • Poll device state every 5-15 minutes for dashboard updates
  • Check current_state_last_updated_at to avoid unnecessary API calls
  • Implement caching to reduce API load
  • Show last update timestamp to users for transparency
  • Show both indoor and outdoor temperatures for context
  • Highlight when indoor temperature is outside comfort range
  • DHW temperature should typically be 45-55°C
  • Consider outdoor temperature for heating efficiency expectations
  • Handle null values gracefully (e.g., missing indoor sensor)
  • Display user-friendly messages for stale data
  • Provide troubleshooting steps when data stops updating

Heat Pump Attributes

Writable parameters and configuration

Dashboard Integration

Building end-user dashboards