Output interpretation

An explanation and interpretation of every feature outputted in the API response.

Field	Type	Description	Example
postcode	string	zip code in six-character format	1234AB
housenumber	integer	house number	1
houseaddition	string	addition to the house number	A
build_year	integer	build year	1961
inner_surface_area	integer	inner surface area (m2)	70
house_type	string	the house type	Vrijstaand
installation	integer	see Measures	4
wall_insulation	integer	see Measures	2
sloped_roof_insulation	integer	see Measures	2
flat_roof_insulation	integer	see Measures	2
floor_insulation	integer	see Measures	2
living_room_windows	integer	see Measures	2
bedroom_windows	integer	see Measures	1
shower	integer	see Measures	1
ventilation	integer	see Measures	1
solar_panels	list	see Measures
CO2	integer	The total CO2 emissions (see CO2)	3084
definitive_energy_label	string	Definitive energylabel from RVO's EP-online	A
definitive_energy_label_type	string	Norm on which the definitive energylabel is based	NEN7120
definitive_energy_label_validity_date	string	Validity end date of the given definitive energylabel	2030-12
definitive_BENG2_score	integer	Definitive energylabel BENG2 score from RVO's EP-online	125
current_estimated_energy_label	string	Current estimated NTA 8800 energylabel with respect to the input based on housetype, buildyear, inner surface area and estimated or given measures	A
current_estimated_BENG2_score	integer	BENG2 numerical score of the current estimated NTA 8800 score	128
estimated_gas_usage	integer	Estimated gas usage (m3) per year	2172
estimated_energy_usage	integer	Estimated electricity usage (kWh) per year	2800
estimated_city_heating_usage	integer	Estimated heat consumption (GJ) per year	1300
measures_method	integer	1= statistical based on def. BENG2 or def. energy label, 2 = supplemented/determined with external sources, 3 = based on building regulations, 4 = based on user input	1

Example output

{
	"Output": {
		"warnings": [],
		"postcode": "2771DS",
		"housenumber": 87,
		"houseaddition": null,
		"build_year": 1961,
		"inner_surface_area": 131,
		"house_type": "Vrijstaand",
		"installation": 4,
		"wall_insulation": 1,
		"sloped_roof_insulation": 1,
		"flat_roof_insulation": 1,
		"floor_insulation": 1,
		"living_room_windows": 2,
		"bedroom_windows": 2,
		"shower": 1,
		"ventilation": 1,
		"solar_panels": [
			{
				"roof_surface": 0,
				"roof_type": "Sloped",
				"total_watt_peak_capacity": 2000.0,
				"current_specific_watt_peak": null,
				"inclination_angle": 45,
				"orientation": 180
			},
			{
				"roof_surface": 1,
				"roof_type": "Sloped",
				"total_watt_peak_capacity": 3000.0,
				"current_specific_watt_peak": null,
				"inclination_angle": 45,
				"orientation": 180
			}
		],
		"CO2": 2633,
		"definitive_energy_label": "A+++",
		"definitive_energy_label_type": "NTA 8800:2024 (basisopname woningbouw)",
		"definitive_energy_label_validity_date": "2036-1",
		"definitive_BENG2_score": 49,
		"current_estimated_energy_label": "D",
		"current_estimated_BENG2_score": 265,
		"estimated_gas_usage": 1697,
		"estimated_energy_usage": 3262,
		"estimated_city_heating_usage": 0,
		"measures_method": 4,
		"response_meta": null
	}
}