# 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="../../sustainability-api-v2/warnings">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="../../sustainability-api-v2-apartments/measures">Measures</a></td><td>4</td></tr><tr><td>wall_insulation</td><td>integer</td><td>see <a href="../../sustainability-api-v2-apartments/measures">Measures</a></td><td>2</td></tr><tr><td>roof_insulation</td><td>integer</td><td>see <a href="../../sustainability-api-v2-apartments/measures">Measures</a></td><td>2</td></tr><tr><td>floor_insulation</td><td>integer</td><td>see <a href="../../sustainability-api-v2-apartments/measures">Measures</a></td><td>2</td></tr><tr><td>living_room_windows</td><td>integer</td><td>see <a href="../../sustainability-api-v2-apartments/measures">Measures</a></td><td>2</td></tr><tr><td>shower</td><td>integer</td><td>see <a href="../../sustainability-api-v2-apartments/measures">Measures</a></td><td>1</td></tr><tr><td>ventilation</td><td>integer</td><td>see <a href="../../sustainability-api-v2-apartments/measures">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="../../sustainability-api-v2-apartments/measures">Measures</a></td><td></td></tr><tr><td>CO2</td><td>integer</td><td>The total CO2 emissions (see <a href="../../sustainability-api-v2-apartments/co-emissions">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>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></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
	}
}
```
