# Output interpretation

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

#### 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
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.altum.ai/english/sustainability/sustainability-api-v2-apartments/output-interpretation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.