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


The heating element is a child of the hvac element. You can only submit one instance of the heating element for each hvac instance. 
NameDescriptionTypeLengthRequiredOptions / Range
typeHeating equipment typestring20Noheat_pump, central_furnace, wall_furnace, baseboard, boiler, gchp, wood_stove, mini_split, none
fuel_primaryPrimary heating fuelstring20Noelectric, natural_gas, lpg, fuel_oil, cord_wood, pellet_wood
efficiency_methodMethod to determine heating efficiencystring20Nouser, shipment_weighted
yearYear equipment was manufactured
(only used if efficiency_method is shipment_weighted)
intNo1970 - current year
efficiencyEfficiency of heating equipment
(only used if efficiency_method is user)
floatNoSee notes
  • The type options are defined as follows:
 type Definition
 central_furnace Central furnace with ducts
 wall_furnace Wall or floor furnace with no ducts
 boiler Central hydronic boiler
 heat_pump Central air source heat pump
 gchp Ground coupled heat pump
 mini_split Mini split heat pump
 baseboard Electric baseboard heaters
 wood_stove Wood stove using cord wood or pellets
 none No heating system is installed

  • If type is set to heat_pump, gchp, or mini_split then the submitted cooling/type must either match or be set to none.
  • The type element determines possible values and ranges of the other elements in heating as follows:
 typefuel_primary efficiency_method year efficiency range  efficiency units
 central_furnace,  wall_furnace,  boiler natural_gas,  lpg, fuel_oil any any 0.6 - 1 AFUE
 heat_pump electric any any 6 - 20 HSPF
 mini_split electric user n/a 6 - 20 HSPF
 gchp electric user n/a 2 - 5 COP (ARI-330)
 baseboard, central_furnace electric n/a n/a n/a n/a
 wood_stove cord_wood,  pellet_wood n/a n/a  n/a  n/a
 none n/a n/a n/a n/a n/a