HVACs

HVAC endpoints expose heating and cooling units linked to an address, including latest temperature state.

Base path: /api/v2/addresses/:address_uuid/hvacs
Permission: READ_HVAC_DATA

What we provide

Payload

Typical HVAC object includes:

• Identity (identifier)
• Brand and model
• Display name and group name
• Category (for example heating)
• lastTemperatureState:
  • time
  • currentTemperature (°C)
  • isActive
• Created / updated timestamps

Current surface boundary

This domain is currently read-oriented inventory and state. You can discover units and inspect the latest temperature state for monitoring and eligibility workflows. Control/write APIs are not part of the documented HVAC surface in this version.

Guidance

• Use list results for asset inventory and program eligibility.
• Treat lastTemperatureState.time as freshness for operational views.
• Design customer-facing automations carefully: HVAC state is comfort-impacting even when only used for monitoring decisions.
• Combine with group/address discovery when building portfolio views.