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 based on building characteristics and measures. For measures_method 2 and 3 this is predicted using Machine Learning.	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. Uses definitive energy label if available. 2 = External sources. Uses Machine Learning for the energy label prediction. 3 = Building regulations. Uses Machine Learning for the energy label prediction. 4 = User input.	1

How the current estimated energy label is calculated (measures_method)

The response includes measures_method. It explains how measures and the estimated label were derived.

• 1: Statistical. Uses definitive BENG2 / energy label if available.

• 2: External sources. Uses Machine Learning for the energy label prediction.

• 3: Building regulations. Uses Machine Learning for the energy label prediction.

• 4: User input. Your provided measures drive the estimate.

The API returns an estimated NTA 8800 outcome. It is not a replacement for an official EP-online registration.

Example output

{
	"Output": {
		"warnings": [],
		"postcode": "2771DS",
		"housenumber": 87,
		"houseaddition": null,
		"build_year": 1961,
		"inner_surface_area": 131,
		"house_type": "Vrijstaand",
		"installation": 6,
		"wall_insulation": 3,
		"sloped_roof_insulation": 4,
		"flat_roof_insulation": 3,
		"floor_insulation": 4,
		"living_room_windows": 3,
		"bedroom_windows": 3,
		"shower": 1,
		"ventilation": 4,
		"solar_panels": null,
		"CO2": 2766,
		"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": "A++",
		"current_estimated_BENG2_score": 63,
		"estimated_gas_usage": 0,
		"estimated_energy_usage": 8135,
		"estimated_city_heating_usage": 0,
		"measures_method": 1,
		"response_meta": null
	}
}