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	house_number	1	House number
address	post_code	1234AB	Zipcode
address	addition	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 pitched 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	apartment_type	Portiekwoning	The house type
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
solar_panels	current		see Measures
solar_panels	potential		see Measures
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	solar_panels		see Measures
measures	installation		see Measures
measures	shower		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
	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": null,
	"warnings": [],
	"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": "single",
		"type": "portiekwoning"
	},
	"label": {
		"current": "C",
		"potential": "C"
	},
	"provided_label": {
		"temporary": "G",
		"definitive": null,
		"definitive_type": null,
		"definitive_validity": null
	},
	"BENG2": {
		"current": 219,
		"potential": 219
	},
	"meta": null,
	"CO2": {
		"current": 2399,
		"potential": 2399
	},
	"financial": {
		"total_investment": 0.0,
		"total_saving": 0.0,
		"months_to_pay_off": 0,
		"eco_value": 0,
		"savings_monthly": 0,
		"energy_cost_monthly": {
			"current": 158,
			"potential": 158
		},
		"energy_cost_yearly": {
			"current": 1902,
			"potential": 1902
		},
		"return_on_investment": "-1.0%",
		"loan": {
			"monthly_payment": null
		}
	},
	"gas_usage": {
		"current": 845,
		"potential": 845
	},
	"electricity_usage": {
		"current": 2712,
		"potential": 2712
	},
	"city_heating_usage": {
		"current": 0,
		"potential": 0
	},
	"solar_panel_yield": {
		"current": 100,
		"potential": 100
	},
	"energy_prices": {
		"variable_gas_price": 1.359,
		"variable_electricity_price": 0.27
	},
	"solar_panels": {
		"current": null,
		"potential": null
	},
	"measures": {
		"wall_insulation": {
			"before": {
				"desc": "Geen",
				"value": 1,
				"points": 2
			},
			"after": {
				"desc": "Geen",
				"value": 1,
				"points": 2
			},
			"investment": 0.0,
			"savings": 0,
			"co2_reduce": 0,
			"BENG2": "0",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"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
}