# Output interpretation

<table><thead><tr><th width="249">Field</th><th>Type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>warnings</td><td>list</td><td>see <a href="/pages/N5pIRcIytAix5eyKB23I">Warnings</a></td><td></td></tr><tr><td>postcode</td><td>string</td><td>zip code in six-character format</td><td>1234AB</td></tr><tr><td>housenumber</td><td>integer</td><td>house number</td><td>1</td></tr><tr><td>houseaddition</td><td>string</td><td>addition to the house number</td><td>A</td></tr><tr><td>build_year</td><td>integer</td><td>build year</td><td>1961</td></tr><tr><td>inner_surface_area</td><td>integer</td><td>inner surface area (m2)</td><td>70</td></tr><tr><td>apartment_type</td><td>string</td><td>the apartment type</td><td>Portiekwoning</td></tr><tr><td>installation</td><td>integer</td><td>see <a href="/pages/DTplmmMlP75yYyVJdcVZ">Measures</a></td><td>4</td></tr><tr><td>wall_insulation</td><td>integer</td><td>see <a href="/pages/DTplmmMlP75yYyVJdcVZ">Measures</a></td><td>2</td></tr><tr><td>roof_insulation</td><td>integer</td><td>see <a href="/pages/DTplmmMlP75yYyVJdcVZ">Measures</a></td><td>2</td></tr><tr><td>floor_insulation</td><td>integer</td><td>see <a href="/pages/DTplmmMlP75yYyVJdcVZ">Measures</a></td><td>2</td></tr><tr><td>living_room_windows</td><td>integer</td><td>see <a href="/pages/DTplmmMlP75yYyVJdcVZ">Measures</a></td><td>2</td></tr><tr><td>shower</td><td>integer</td><td>see <a href="/pages/DTplmmMlP75yYyVJdcVZ">Measures</a></td><td>1</td></tr><tr><td>ventilation</td><td>integer</td><td>see <a href="/pages/DTplmmMlP75yYyVJdcVZ">Measures</a></td><td>1</td></tr><tr><td>cooling</td><td>integer</td><td><p>1 = No cooling</p><p>2 = Air conditioning unit, direct air cooling</p></td><td>1</td></tr><tr><td>electric_cooking</td><td>integer</td><td><p>1 = Gas stove</p><p>2 = Electric stove</p></td><td>1</td></tr><tr><td>solar_panels</td><td>list</td><td>see <a href="/pages/DTplmmMlP75yYyVJdcVZ">Measures</a></td><td></td></tr><tr><td>CO2</td><td>integer</td><td>The total CO2 emissions (see <a href="/pages/AmlSU4p7s624xFGplNmP">CO2</a>)</td><td>3084</td></tr><tr><td>definitive_energy_label</td><td>string</td><td>Definitive energylabel from RVO's EP-online</td><td>A</td></tr><tr><td>definitive_energy_label_type</td><td>string</td><td>Norm on which the definitive energylabel is based</td><td>NEN7120</td></tr><tr><td>definitive_energy_label_validity_date</td><td>string</td><td>Validity end date of the given definitive energylabel</td><td>2030-12</td></tr><tr><td>definitive_BENG2_score</td><td>integer</td><td>Definitive energylabel BENG2 score from RVO's EP-online</td><td>125</td></tr><tr><td>current_estimated_energy_label</td><td>string</td><td>Current estimated NTA 8800 energylabel based on building characteristics and measures. For <code>measures_method</code> 2 and 3 this is predicted using Machine Learning.</td><td>A</td></tr><tr><td>current_estimated_BENG2_score</td><td>integer</td><td>BENG2 numerical score of the current estimated NTA 8800 score</td><td>128</td></tr><tr><td>estimated_gas_usage</td><td>integer</td><td>Estimated gas usage (m3) per year</td><td>2172</td></tr><tr><td>estimated_energy_usage</td><td>integer</td><td>Estimated electricity usage (kWh) per year</td><td>2800</td></tr><tr><td>estimated_city_heating_usage</td><td>integer</td><td>Estimated heat consumption (GJ) per year</td><td>1300</td></tr><tr><td>solar_panel_yield</td><td>integer</td><td>Electricity yield (kWh) per year</td><td>1000</td></tr><tr><td>measures_method</td><td>integer</td><td><p><code>1</code> = Statistical. </p><p><code>2</code> = External sources. </p><p><code>3</code> = Building characteristics.</p><p><code>4</code> = User input.</p></td><td>1</td></tr><tr><td>accuracy_indicator</td><td>integer</td><td>see <a href="https://app.gitbook.com/o/pLuAKZrbll04y6968KwP/s/-Lw4gk5ARKsgVHFCdPZw/~/edit/~/changes/1415/sustainability/nta-8800-energylabel-v2-api/apartments/accuracy-indicator">Accuracy indicator</a></td><td>5</td></tr></tbody></table>

### How the current estimated energy label is calculated (`measures_method`)

The response includes `measures_method`. It explains how measures and the estimated label were derived.

* `1`: **Statistical:** Uses the **NTA 8800 model** and the **definitive energy label** if it is available.
* `2`: **External sources**: Uses **machine learning predictions based on external data sources** to support the **NTA 8800 model** estimation when a definitive energy label is not available.
* `3`: **Building characteristics:** Uses **machine learning predictions based on building characteristics** to support the **NTA 8800 model** estimation when a definitive energy label and external sources are not available.
* `4`: **User input:** The estimation is driven by the **measures provided in the request and the building characteristics** which are used to support the **NTA 8800 model.** This method is used when **at least one measure** is supplied by the user.
* The measures:
  * `installation`
  * `wall_insulation`
  * `roof_insulation`
  * `floor_insulation`
  * `living_room_windows`
  * `shower`
  * `ventilation`
  * `cooling`
  * `electirc_cooking`
  * `solar_panels`

{% hint style="info" %}
The API returns an **estimated** NTA 8800 outcome. It is not a replacement for an official EP-online registration.
{% endhint %}

#### Example output

```
{
	"Output": {
		"warnings": [],
		"tip": null,
		"postcode": "3024XL",
		"housenumber": 227,
		"houseaddition": "B",
		"build_year": 1927,
		"inner_surface_area": 74,
		"apartment_type": "Portiekwoning",
		"installation": 4,
		"wall_insulation": 1,
		"roof_insulation": null,
		"floor_insulation": null,
		"living_room_windows": 2,
		"shower": 1,
		"ventilation": 1,
		"cooling": 1,
		"electric_cooking": 1,
		"solar_panels": null,
		"CO2": 2280,
		"definitive_energy_label": null,
		"definitive_energy_label_type": null,
		"definitive_energy_label_validity_date": null,
		"definitive_BENG2_score": null,
		"current_estimated_energy_label": "C",
		"current_estimated_BENG2_score": 221,
		"estimated_gas_usage": 845,
		"estimated_energy_usage": 2262,
		"estimated_city_heating_usage": 0,
		"measures_method": 2,
		"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/nta-8800-energylabel-v2-api/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.
