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	go to Energylabel page
label:potential	A	go to Energylabel page
provided_label:temporary	C	go to Energylabel page
provided_label:definitive	A+	go to Energylabel page
provided_label:definitive_type	NTA8800	go to Energylabel page
provided_label:definitive_validity	31-12-2030	go to Energylabel page
BENG2:current	200	go to Energylabel page
BENG2:potential	50	go to 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	go to Comfortscore page
comfortscore:potential	5	go to Comfortscore page
CO2:current	10000	go to CO2 page
CO2:potential	5000	go to 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
after:desc	Zeer goed	see Measures page
after:value	3	see Measures 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,
		"type": "vrijstaand"
	},
	"label": {
		"current": "G",
		"potential": "A"
	},
	"provided_label": {
		"temporary": "F",
		"definitive": "C",
		"definitive_type": null,
		"definitive_validity": null
	},
	"BENG2": {
		"current": 422,
		"potential": 110
	},
	"meta": null,
	"energyindex": {
		"current": null,
		"potential": null
	},
	"ELG": {
		"current": null,
		"potential": null
	},
	"comfortscore": {
		"current": 1,
		"potential": 3
	},
	"CO2": {
		"current": 10632,
		"potential": 4144
	},
	"financial": {
		"total_investment": 26703.83,
		"total_saving": 4148.3,
		"months_to_pay_off": 77,
		"eco_value": 78670.0,
		"savings_monthly": 346,
		"energy_cost_monthly": 471,
		"loan": {
			"monthly_payment": 111.0
		}
	},
	"usage": {
		"gas": 6059,
		"energy": 4077
	},
	"usage_potential": {
		"gas": 1909,
		"energy": 1036
	},
	"energy_prices": {
		"variable_gas_price": 0.774,
		"variable_electricity_price": 0.223,
		"solarpanel_watt_peak_per_m2": 212
	},
	"measures": {
		"wall_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0
			},
			"after": {
				"desc": "Geen",
				"value": 0
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"floor_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0
			},
			"after": {
				"desc": "Zeer goed",
				"value": 3
			},
			"investment": 2994.39,
			"saving": 1107,
			"co2_reduce": 2541,
			"BENG2": "23.8%",
			"gas_savings": 1377,
			"electricity_savings": 185
		},
		"roof_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2
			},
			"investment": 8103.42,
			"saving": 1309,
			"co2_reduce": 3005,
			"BENG2": "28.1%",
			"gas_savings": 1629,
			"electricity_savings": 218
		},
		"living_room_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1
			},
			"after": {
				"desc": "HR++ glas",
				"value": 2
			},
			"investment": 3503.18,
			"saving": 90,
			"co2_reduce": 208,
			"BENG2": "1.9%",
			"gas_savings": 113,
			"electricity_savings": 15
		},
		"bedroom_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"ventilation": {
			"before": {
				"desc": "Natuurlijk",
				"value": 0
			},
			"after": {
				"desc": "Natuurlijk",
				"value": 0
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"solar_panels": {
			"before": {
				"desc": "0",
				"value": 0
			},
			"after": {
				"desc": "21",
				"value": 21
			},
			"investment": 4749.67,
			"saving": 1192,
			"co2_reduce": 1988,
			"BENG2": "10%",
			"gas_savings": 0,
			"electricity_savings": 5346
		},
		"instalation": {
			"before": {
				"desc": "HR-combi",
				"value": 4
			},
			"after": {
				"desc": "Hybride warmtepomp",
				"value": 30
			},
			"investment": 7353.17,
			"saving": 386,
			"co2_reduce": -54,
			"BENG2": "9.5%",
			"gas_savings": 1067,
			"electricity_savings": -3125
		},
		"shower": {
			"before": {
				"desc": "Geen Douche WTW",
				"value": 0
			},
			"after": {
				"desc": "Geen Douche WTW",
				"value": 0
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		}
	},
	"response_meta": null
}