Output interpretation

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

Feature	Example	Explanation
house_number	1	House number
post_code	1234AB	Zipcode
addition	A	House number addition
street	Dorpstraat	Street name
city	Amsterdam	City name
location (lat/lon)	52.06839 / 4.65808	GPS coördinates
build_year	2001	Construction year
inner_surface	120	Square meters livable space
floor_surface	73	Square meters floor
flat_roof_surface	18	Square meters flat roof
pitched_roof_surface	81	Square meters pitched roof
wall_surface	113	Square meters wall
glass_living_room_surface	24	Square meters glass livingroom
glass_bedrooms_surface	6	Square meters glass bedrooms
type	Vrijstaand	House type: '2 onder 1 kap' 'hoekwoning', 'tussenwoning', 'vrijstaand' or 'appartment'
label:current	G	see Energylabel page
label:potential	A	see Energylabel page
provided_label:temporary	C	see Energylabel page
provided_label:definitive	A+	see Energylabel page
provided_label:definitive_type	NTA8800	see Energylabel page
provided_label:definitive_validity	31-12-2030	see Energylabel page
BENG1:current	165	see Energylabel page
BENG1:potential	139	see Energylabel page
BENG2:current	200	see Energylabel page
BENG2:potential	50	see Energylabel page
meta	null	to be ignored
energyindex:current	null	legacy feature, defunct
energyindex:potential	null	legacy feature, defunct
ELG:current	null	legacy feature, defunct
ELG:potential	null	legacy feature, defunct
comfortscore:current	1	see Comfortscore page
comfortscore:potential	5	see Comfortscore page
CO2:current	10000	see CO2 page
CO2:potential	5000	see CO2 page
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:loan:monthly_payment	111	monthly payment in € when financing
usage:gas	6059	estimated or given gas usage in m3 per year
usage:energy	4077	estimated kWh per year
usage:city_heating	1000	estimated GJ per year
usage_potential:gas	1909	estimated new situation usage in m3 per year
usage_potential:energy	1036	estimated new situation usage in kWh per year
usage_potential:city_heating	1000	estimated new situation usage in GJ per year
energy_price:variable_gas_price	0.774	gas price per m3 used for calculations
energy_price:variable_electricity_price	0.223	electricity price per kWh used for calculations
energy_price:solarpanel_watt_peak_per_m2	212	watt peak performance used for solar panels
measures:wall_insulation	see for every measure	see Measures page
measures:floor_insulation	see for every measure	see Measures page
measures:roof_insulation	see for every measure	see Measures page
measures:living_room_windows	see for every measure	see Measures page
measures:bedroom_windows	see for every measure	see Measures page
measures:ventilation	see for every measure	see Measures page
measures:solar_panels	see for every measure	see Measures page
measures:instalation	see for every measure	see Measures page
measures:shower	see for every measure	see Measures page
for every measure		see Measures page
before:desc	Geen	see Measures page
before:value	0	see Measures page
before:points	0	see Comfortscore page
after:desc	Zeer goed	see Measures page
after:value	3	see Measures page
after:points	7	see Comfortscore page
investment	2994.39	cost of investment for the specific measure
saving	1107	yearly savings in energy costs as a result of the specific measure
co2_reduce	2541	see CO2 page, 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

{
	"address": {
		"house_number": 87,
		"post_code": "2771DS",
		"addition": null,
		"street": "Zuidkade",
		"city": "Boskoop",
		"location": {
			"lat": 52.06839381665532,
			"lon": 4.6580852694533394
		}
	},
	"building": {
		"build_year": 1961,
		"inner_surface": 131.0,
		"floor_surface": 97.0,
		"flat_roof_surface": 0,
		"pitched_roof_surface": 124.4,
		"wall_surface": 150.7,
		"glass_living_room_surface": 24.9,
		"glass_bedrooms_surface": 6.9,
		"type": "vrijstaand"
	},
	"label": {
		"current": "G",
		"potential": "A++++"
	},
	"provided_label": {
		"temporary": "F",
		"definitive": "C",
		"definitive_type": null,
		"definitive_validity": null
	},
	"BENG1": {
		"current": 165,
		"potential": 139
	},
	"BENG2": {
		"current": 422,
		"potential": -1
	},
	"meta": null,
	"energyindex": {
		"current": null,
		"potential": null
	},
	"ELG": {
		"current": null,
		"potential": null
	},
	"comfortscore": {
		"current": 1,
		"potential": 3
	},
	"CO2": {
		"current": 10632,
		"potential": 2564
	},
	"financial": {
		"total_investment": 67638.64,
		"total_saving": 8119.28,
		"months_to_pay_off": 99,
		"eco_value": null,
		"savings_monthly": 677,
		"energy_cost_monthly": 681,
		"loan": {
			"monthly_payment": 280.0
		}
	},
	"usage": {
		"gas": 6059,
		"energy": 4077,
		"city_heating": 0
	},
	"usage_potential": {
		"gas": 0,
		"energy": 903,
		"city_heating": 0
	},
	"energy_prices": {
		"variable_gas_price": 1.144,
		"variable_electricity_price": 0.293,
		"solarpanel_watt_peak_per_m2": 212
	},
	"measures": {
		"wall_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 2
			},
			"after": {
				"desc": "Geen",
				"value": 0,
				"points": 2
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"floor_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2,
				"points": 7
			},
			"investment": 2865.38,
			"saving": 1426,
			"co2_reduce": 2223,
			"BENG2": "20.8%",
			"gas_savings": 1205,
			"electricity_savings": 161
		},
		"roof_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2,
				"points": 3
			},
			"investment": 12441.24,
			"saving": 1928,
			"co2_reduce": 3005,
			"BENG2": "28.1%",
			"gas_savings": 1629,
			"electricity_savings": 218
		},
		"living_room_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": 1
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": 1
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"bedroom_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": null
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": null
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"ventilation": {
			"before": {
				"desc": "Natuurlijk",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Natuurlijk",
				"value": 0,
				"points": 0
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"solar_panels": {
			"before": {
				"desc": "0",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "59",
				"value": 59,
				"points": null
			},
			"investment": 21849.7,
			"saving": 3279,
			"co2_reduce": 3705,
			"BENG2": "19%",
			"gas_savings": 0,
			"electricity_savings": 11192
		},
		"instalation": {
			"before": {
				"desc": "HR-combi",
				"value": 4,
				"points": 15
			},
			"after": {
				"desc": "WP bodem combi",
				"value": 7,
				"points": 20
			},
			"investment": 29686.14,
			"saving": 2665,
			"co2_reduce": 4254,
			"BENG2": "64.0%",
			"gas_savings": 6059,
			"electricity_savings": -15438
		},
		"shower": {
			"before": {
				"desc": "Geen Douche WTW",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "Douche WTW",
				"value": 1,
				"points": null
			},
			"investment": 796.18,
			"saving": 93,
			"co2_reduce": 146,
			"BENG2": "0.4%",
			"gas_savings": 82,
			"electricity_savings": 0
		}
	},
	"response_meta": null
}