Output interpretation

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

Field	Type	Description	Example
warnings	list	see Warnings
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
apartment_type	string	the apartment type	Portiekwoning
installation	integer	see Measures	4
wall_insulation	integer	see Measures	2
roof_insulation	integer	see Measures	2
floor_insulation	integer	see Measures	2
living_room_windows	integer	see Measures	2
shower	integer	see Measures	1
ventilation	integer	see Measures	1
cooling	integer	1 = No cooling 2 = Air conditioning unit, direct air cooling	1
electric_cooking	integer	1 = Gas stove 2 = Electric stove	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. 2 = External sources. 3 = Building characteristics. 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 the NTA 8800 model and the definitive energy label if it is available.

• 2: External sources: Uses machine learning predictions based on external data sources to support the NTA 8800 model estimation when a definitive energy label is not available.

• 3: Building characteristics: Uses machine learning predictions based on building characteristics to support the NTA 8800 model estimation when a definitive energy label and external sources are not available.

• 4: User input: The estimation is driven by the measures provided in the request and the building characteristics which are used to support the NTA 8800 model. This method is used when at least one measure is supplied by the user.

• The measures:

  • installation

  • wall_insulation

  • roof_insulation

  • floor_insulation

  • living_room_windows

  • shower

  • ventilation

  • cooling

  • electirc_cooking

  • solar_panels

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

Example output

{
	"Output": {
		"warnings": [],
		"tip": null,
		"postcode": "3024XL",
		"housenumber": 227,
		"houseaddition": "B",
		"build_year": 1927,
		"inner_surface_area": 74,
		"apartment_type": "Portiekwoning",
		"installation": 4,
		"wall_insulation": 1,
		"roof_insulation": null,
		"floor_insulation": null,
		"living_room_windows": 2,
		"shower": 1,
		"ventilation": 1,
		"cooling": 1,
		"electric_cooking": 1,
		"solar_panels": null,
		"CO2": 2280,
		"definitive_energy_label": null,
		"definitive_energy_label_type": null,
		"definitive_energy_label_validity_date": null,
		"definitive_BENG2_score": null,
		"current_estimated_energy_label": "C",
		"current_estimated_BENG2_score": 221,
		"estimated_gas_usage": 845,
		"estimated_energy_usage": 2262,
		"estimated_city_heating_usage": 0,
		"measures_method": 2,
		"response_meta": null
	}
}