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

label:potential

A

provided_label:temporary

C

provided_label:definitive

A+

provided_label:definitive_type

NTA8800

provided_label:definitive_validity

31-12-2030

BENG1:current

165

BENG1:potential

139

BENG2:current

200

BENG2:potential

50

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

comfortscore:potential

5

CO2:current

10000

CO2:potential

5000

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

measures:floor_insulation

see for every measure

measures:roof_insulation

see for every measure

measures:living_room_windows

see for every measure

measures:bedroom_windows

see for every measure

measures:ventilation

see for every measure

measures:solar_panels

see for every measure

measures:instalation

see for every measure

measures:shower

see for every measure

for every measure

before:desc

Geen

before:value

0

before:points

0

after:desc

Zeer goed

after:value

3

after:points

7

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

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
}

Last updated