# 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="/pages/N5pIRcIytAix5eyKB23I">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="/pages/N5pIRcIytAix5eyKB23I">Warnings</a></td></tr><tr><td>address</td><td>house_number</td><td>1</td><td>House number</td></tr><tr><td>address</td><td>post_code</td><td>1234AB</td><td>Zipcode</td></tr><tr><td>address</td><td>addition</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>flat_roof_surface</td><td>18</td><td>Square meters flat roof</td></tr><tr><td>building</td><td>pitched_roof_surface</td><td>81</td><td>Square meters pitched 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>glass_bedrooms_surface</td><td>6</td><td>Square meters glass bedrooms</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>type</td><td>Vrijstaand</td><td>The house type</td></tr><tr><td>label</td><td>current</td><td>G</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">Energylabel</a></td></tr><tr><td>label</td><td>potential</td><td>A</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">Energylabel</a></td></tr><tr><td></td><td>accuracy_indicator</td><td>6</td><td>see <a href="/pages/aH4KnZ0Ppgrfop4SbiO3">Accuracy indicator</a></td></tr><tr><td>provided_label</td><td>temporary</td><td>C</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">Energylabel</a></td></tr><tr><td>provided_label</td><td>definitive</td><td>A+</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">Energylabel</a></td></tr><tr><td>provided_label</td><td>definitive_type</td><td>NTA8800</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">Energylabel</a></td></tr><tr><td>provided_label</td><td>definitive_validity</td><td>31-12-2030</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">Energylabel</a></td></tr><tr><td>provided_label</td><td>definitive_beng2</td><td>49</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">Energylabel</a></td></tr><tr><td>BENG2</td><td>current</td><td>200</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">Energylabel</a></td></tr><tr><td>BENG2</td><td>potential</td><td>50</td><td>see <a href="/pages/Uzmz1OzkpUDccSiOs2mJ">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/zk2hXTqYwq8fl98VkNl0">CO2</a></td></tr><tr><td>CO2</td><td>potential</td><td>5000</td><td>see <a href="/pages/zk2hXTqYwq8fl98VkNl0">CO2</a></td></tr><tr><td>grid_import</td><td>current</td><td>1405</td><td>Annual electricity from the electricity grid in kWh</td></tr><tr><td>grid_import</td><td>potential</td><td>2058</td><td>Annual electricity from the electricity grid in kWh</td></tr><tr><td>grid_feed</td><td>current</td><td>0</td><td>Annual electricity to the electricity grid in kWh</td></tr><tr><td>grid_feed</td><td>potential</td><td>2808</td><td>Annual electricity to the electricity grid in kWh</td></tr><tr><td>electricity_need</td><td>current</td><td>1405</td><td>Annual electricity demand in kWh</td></tr><tr><td>electricity_need</td><td>potential</td><td>0</td><td>Annual electricity demand in kWh</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_panels</td><td>summary.current</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>solar_panels</td><td>summary.potential</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>solar_panels</td><td>systems.current</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>solar_panels</td><td>systems.potential</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>battery</td><td>current</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>battery</td><td>potential</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>wall_insulation</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>floor_insulation</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>sloped_roof_insulation</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>flat_roof_insulation</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>measuresliving_room_windows</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>bedroom_windows</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>ventilation</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>solar_panels</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>installation</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td>measures</td><td>shower</td><td></td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">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/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td></td><td>before:value</td><td>0</td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">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/lTx2NHwgiCOJyDOD5owQ">Measures</a></td></tr><tr><td></td><td>after:value</td><td>3</td><td>see <a href="/pages/lTx2NHwgiCOJyDOD5owQ">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/zk2hXTqYwq8fl98VkNl0">CO2</a></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

```
{
  "warnings": [],
  "address": {
    "housenumber": 87,
    "postcode": "2771DS",
    "houseaddition": null,
    "street": "Zuidkade",
    "city": "Boskoop",
    "location": {
      "lat": 52.0683938167,
      "lon": 4.6580852695
    }
  },
  "building": {
    "build_year": 1961,
    "inner_surface": 131,
    "floor_surface": 80.8,
    "flat_roof_surface": 5.2,
    "pitched_roof_surface": 98.9,
    "wall_surface": 126.1,
    "glass_living_room_surface": 11.1,
    "glass_bedrooms_surface": 16.6,
    "number_of_doors": 6,
    "type": "Vrijstaand"
  },
  "label": {
    "current": "E",
    "potential": "A++"
  },
  "accuracy_indicator": 6,
  "provided_label": {
    "temporary": "F",
    "definitive": "A+++",
    "definitive_type": "NTA 8800:2024 (basisopname woningbouw)",
    "definitive_validity": "2036-1",
    "definitive_beng2": 49
  },
  "BENG2": {
    "current": 295,
    "potential": 70
  },
  "meta": null,
  "CO2": {
    "current": 3456,
    "potential": 1329
  },
  "grid_import": {
    "current": 1405,
    "potential": 2058
  },
  "grid_feed": {
    "current": 0,
    "potential": 2808
  },
  "electricity_need": {
    "current": 1405,
    "potential": 0
  },
  "financial": {
    "total_investment": 13713,
    "total_saving": 1381,
    "months_to_pay_off": 119,
    "eco_value": 150977,
    "savings_monthly": 115,
    "energy_cost_monthly": {
      "current": 243,
      "potential": 128
    },
    "energy_cost_yearly": {
      "current": 2921,
      "potential": 1540
    },
    "return_on_investment": "3.28%",
    "loan": {
      "monthly_payment": 57
    }
  },
  "gas_usage": {
    "current": 1666,
    "potential": 744
  },
  "electricity_usage": {
    "current": 3263,
    "potential": 7262
  },
  "city_heating_usage": {
    "current": 0,
    "potential": 0
  },
  "energy_prices": {
    "variable_gas_price": 1.359,
    "variable_electricity_price": 0.27,
    "solarpanel_watt_peak_per_m2": 250
  },
  "solar_panels": {
    "summary": {
      "current": {
        "pv_generation": 1920,
        "curtailed_pv": 0,
        "self_consumed_pv": 1920,
        "self_consumed_ratio": 1,
        "netting_enabled": 1
      },
      "potential": {
        "pv_generation": 8258,
        "curtailed_pv": 0,
        "self_consumed_pv": 5450,
        "self_consumed_ratio": 0,
        "netting_enabled": 1
      }
    },
    "systems": {
      "current": [
        {
          "roof_surface": 0,
          "roof_type": "Sloped",
          "original_watt_peak_capacity": null,
          "total_watt_peak_capacity": 2000,
          "inclination_angle": 45,
          "orientation": 180,
          "added_watt_peak_capacity": null,
          "specific_watt_peak_of_added_panels": null,
          "added_panels": null,
          "panel_size": null
        }
      ],
      "potential": [
        {
          "roof_surface": 0,
          "roof_type": "Sloped",
          "original_watt_peak_capacity": 2000,
          "total_watt_peak_capacity": null,
          "inclination_angle": 45,
          "orientation": 180,
          "added_watt_peak_capacity": null,
          "specific_watt_peak_of_added_panels": null,
          "added_panels": null,
          "panel_size": null
        },
        {
          "roof_surface": 1,
          "roof_type": "sloped",
          "original_watt_peak_capacity": null,
          "total_watt_peak_capacity": null,
          "inclination_angle": 45,
          "orientation": 180,
          "added_watt_peak_capacity": 6600,
          "specific_watt_peak_of_added_panels": null,
          "added_panels": 16,
          "panel_size": null
        }
      ]
    }
  },
  "battery": {
    "current": [
      {
        "type": "custom",
        "capacity": 12,
        "power": 6,
        "control_mode": "pv_only",
        "charge": 718,
        "discharge": 655,
        "cycles": 60.7
      }
    ],
    "potential": [
      {
        "type": "custom",
        "capacity": 12,
        "power": 6,
        "control_mode": "pv_only",
        "charge": 2592,
        "discharge": 2347,
        "cycles": 217.3
      }
    ]
  },
  "measures": {
    "wall_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 2
      },
      "after": {
        "desc": "Geen",
        "value": 1,
        "points": 2
      },
      "investment": 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,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "sloped_roof_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "flat_roof_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "investment": 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,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "bedroom_windows": {
      "before": {
        "desc": "Dubbel glas",
        "value": 2,
        "points": null
      },
      "after": {
        "desc": "Dubbel glas",
        "value": 2,
        "points": null
      },
      "investment": 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": "Hybride WP",
        "value": 8,
        "points": 20
      },
      "investment": 6621,
      "savings": 547,
      "co2_reduce": 941,
      "BENG2": "70",
      "gas_savings": 922,
      "electricity_savings": -1999
    },
    "shower": {
      "before": {
        "desc": "Geen Douche WTW",
        "value": 1,
        "points": null
      },
      "after": {
        "desc": "Geen Douche WTW",
        "value": 1,
        "points": null
      },
      "investment": 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,
      "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,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "solar_panels": {
      "before": {
        "desc": "4",
        "value": 4,
        "points": null
      },
      "after": {
        "desc": "20",
        "value": 20,
        "points": null
      },
      "investment": 7091,
      "savings": 780,
      "co2_reduce": 1184,
      "BENG2": "29",
      "gas_savings": 0,
      "electricity_savings": 5867
    },
    "electric_cooking": {
      "before": {
        "desc": "Gas stove",
        "value": 1,
        "points": null
      },
      "after": {
        "desc": "Gas stove",
        "value": 1,
        "points": null
      },
      "investment": 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/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.