Home Energy Scoring‎ > ‎API Definitions‎ > ‎API Methods‎ > ‎submit_inputs()‎ > ‎building‎ > ‎systems‎ > ‎


The domestic_hot_water element is a child of the systems element. You can only submit one instance of the domestic_hot_water element.
NameDescriptionTypeLengthRequiredOptions / Range
categoryWater heater categorystring20Nounit, combined
typeWater heater typestring20Nostorage, indirect, tankless_coil, heat_pump
fuel_primaryPrimary water heater fuelstring20Noelectric, natural_gas, lpg, fuel_oil
efficiency_methodMethod to determine water heater efficiencystring20Nouser, shipment_weighted
yearYear water heater was manufactured
(only used if efficiency_method is shipment_weighted)
intNo1972 - current year
energy_factorEnergy factor of water heater
(only used if efficiency_method is user)
floatNoSee notes
  • The category element can only be set to combined if the heating/type is boiler and the boiler provides the domestic hot water.
  • The type element can only be set to indirect or tankless_coil if category is set to combined.
  • The fuel_primary,  efficiency_method and year elements are only used if type is set to storage or heat_pump.
  • The type element determines possible values and ranges of the other elements in domestic_hot_water as follows
 type efficiency_method energy_factor range
 storage any 0.45 - 1.0
 indirect n/a n/a
 tankless_coil  n/a n/a
 heat_pump user 1.0 - 4.0