Output interpretation

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

Category	Feature	Example	Explanation
warnings	code	03	see Warnings
warnings	description	"wall_insulation: 2 is not allowed for build_year: 2010. Allowed values: [4]. Set wall_insulation: 4."	see Warnings
address	housenumber	1	House number
address	postcode	1234AB	Zipcode
address	houseaddition	A	House number addition
address	street	Dorpstraat	Street name
address	city	Amsterdam	City name
address	location.lat	52.06839	Coordinates
address	location.lon	4.65808	Coordinates
building	build_year	2001	Construction year
building	inner_surface	120	Square meters livable space
building	floor_surface	73	Square meters floor
building	roof_surface	81	Square meters roof
building	wall_surface	113	Square meters wall
building	glass_living_room_surface	24	Square meters glass livingroom
building	number _of_doors	5	Number of doors
building	floors	"Multiple"
building	"main_type"	"Appartement"
building	"sub_type"	"Portiekwoning"
label	current	G	see Energylabel
label	potential	A	see Energylabel
provided_label	temporary	C	see Energylabel
provided_label	definitive	A+	see Energylabel
provided_label	definitive_type	NTA8800	see Energylabel
provided_label	definitive_validity	31-12-2030	see Energylabel
BENG2	current	200	see Energylabel
BENG2	potential	50	see Energylabel
	meta	null	to be ignored
CO2	current	10000	see CO2
CO2	potential	5000	see CO2
financial	total_investment	26703.83	total cost investment in €
financial	total_savings	4148	yearly savings in €, when ALL measures are implemented
financial	months_to_pay_off	77	months it takes to pay off investment when financed
financial	eco_value	30146	estimated market value increase in €
financial	savings_monthly	346	monthly savings in €
financial	energy_cost_monthly	471	estimated new monthly energy bill in €
financial	energy_cost_monthly.current	235	monthly costs in €
financial	energy_cost_monthly.potential	228	monthly costs in €
financial	energy_cost_yearly.current	2817	yearly costs in €
financial	energy_cost_yearly.potential	2737	yearly costs in €
financial	return_on_investment	1.12%
financial	loan:monthly_payment	111	monthly payment in € when financing
gas_usage	current	1379	estimated or given gas usage in m^3/year
gas_usage	potential	1305	estimated new situation usage in m^3/year
electricity_usage	current	4077	estimated or given electricity usage in kWh/year
electricity_usage	potential	1000	estimated new situation electricity usage in kWh/year
city_heating	current	1909	estimated or given city heating usage in GJ/year
city_heating	potential	1036	estimated new situation city heating usage in GJ/year
solar_panel_yield	current
solar_panel_yield	potential
energy_prices	variable_gas_price	1.359
energy_prices	variable_electricity_price	0.27
energy_prices	solarpanel_watt_peak_per_m2	250
solar_panels	current
solar_panels	potential
measures	wall_insulation		see Measures
measures	floor_insulation		see Measures
measures	roof_insulation		see Measures
measures	living_room_windows		see Measures
measures	ventilation		see Measures
measures	installation		see Measures
measures	shower		see Measures
measures	cooling		see Measures
measures	electric_cooking		see Measures
measures	solar_panels		see Measures
	for every measure
	before:desc	Geen	see Measures
	before:value	0	see Measures
	before:points	0
	after:desc	Zeer goed	see Measures
	after:value	3	see Measures
	after:points	7
	investment	2994.39	cost of investment for the specific measure
	savings	1107	yearly savings in energy costs as a result of the specific measure
	co2_reduce	2541	see CO2 per year
	BENG2	23.8%	relative BENG2 impact (energylabel) as a result of the specific measure
	gas_savings	1377	yearly gas savings in m^3 as a result of the specific measure
	electricity_savings	185	yearly electricity savings in kWh as a result of the specific measure
response_meta		null	to be ignored

Example output

{
	"tip": "Specifying both the position and the floors of the apartment is recommended for optimal results.",
	"warnings": [
		{
			"code": "11",
			"description": "Current building with energy label C already meets default target_label A."
		}
	],
	"address": {
		"housenumber": 227,
		"postcode": "3024XL",
		"houseaddition": "B",
		"street": "Willem Buytewechstraat",
		"city": "Rotterdam",
		"location": {
			"lat": 51.90761152288453,
			"lon": 4.451398538183942
		}
	},
	"building": {
		"build_year": 1927,
		"inner_surface": 74.0,
		"floor_surface": 0,
		"roof_surface": 0,
		"wall_surface": 50.2,
		"glass_living_room_surface": 13.4,
		"number_of_doors": 5,
		"floors": "Multiple",
		"main_type": "Appartement",
		"sub_type": "Portiekwoning"
	},
	"label": {
		"current": "C",
		"potential": "A"
	},
	"provided_label": {
		"temporary": "G",
		"definitive": null,
		"definitive_type": null,
		"definitive_validity": null
	},
	"BENG2": {
		"current": 221,
		"potential": 156
	},
	"meta": null,
	"CO2": {
		"current": 2280,
		"potential": 2047
	},
	"financial": {
		"total_investment": 2309.0,
		"total_saving": 178.0,
		"months_to_pay_off": 155,
		"eco_value": 0,
		"savings_monthly": 15,
		"energy_cost_monthly": {
			"current": 170,
			"potential": 155
		},
		"energy_cost_yearly": {
			"current": 2038,
			"potential": 1860
		},
		"return_on_investment": "0.65%",
		"loan": {
			"monthly_payment": 10.0
		}
	},
	"gas_usage": {
		"current": 845,
		"potential": 716
	},
	"electricity_usage": {
		"current": 2262,
		"potential": 2255
	},
	"city_heating_usage": {
		"current": 0,
		"potential": 0
	},
	"solar_panel_yield": {
		"current": 0,
		"potential": 0
	},
	"energy_prices": {
		"variable_gas_price": 1.359,
		"variable_electricity_price": 0.27,
		"solarpanel_watt_peak_per_m2": 250
	},
	"solar_panels": {
		"current": null,
		"potential": null
	},
	"measures": {
		"wall_insulation": {
			"before": {
				"desc": "Geen",
				"value": 1,
				"points": 2
			},
			"after": {
				"desc": "Goed",
				"value": 3,
				"points": 5
			},
			"investment": 2309.0,
			"savings": 177,
			"co2_reduce": 233,
			"BENG2": "100",
			"gas_savings": 128,
			"electricity_savings": 7
		},
		"floor_insulation": {
			"before": {
				"desc": "Geen",
				"value": 1,
				"points": 0
			},
			"after": {
				"desc": "Geen",
				"value": 1,
				"points": 0
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"roof_insulation": {
			"before": {
				"desc": "Geen",
				"value": 1,
				"points": 0
			},
			"after": {
				"desc": "Geen",
				"value": 1,
				"points": 0
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"living_room_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 2,
				"points": 1
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 2,
				"points": 1
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"installation": {
			"before": {
				"desc": "HR combi ketel",
				"value": 4,
				"points": 15
			},
			"after": {
				"desc": "HR combi ketel",
				"value": 4,
				"points": 15
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"shower": {
			"before": {
				"desc": "Geen Douche WTW",
				"value": 1,
				"points": null
			},
			"after": {
				"desc": "Geen Douche WTW",
				"value": 1,
				"points": null
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"cooling": {
			"before": {
				"desc": "No cooling",
				"value": 1,
				"points": null
			},
			"after": {
				"desc": "No cooling",
				"value": 1,
				"points": null
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"ventilation": {
			"before": {
				"desc": "Natuurlijke ventilatie",
				"value": 1,
				"points": 0
			},
			"after": {
				"desc": "Natuurlijke ventilatie",
				"value": 1,
				"points": 0
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"solar_panels": {
			"before": {
				"desc": "0",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "0",
				"value": 0,
				"points": null
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"electric_cooking": {
			"before": {
				"desc": "Gas stove",
				"value": 1,
				"points": null
			},
			"after": {
				"desc": "Gas stove",
				"value": 1,
				"points": null
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		}
	},
	"response_meta": null
}