Output interpretation

An explanation and interpretation of every feature outputted in the API response.

Category
Feature
Example
Explanation

warnings

code

03

warnings

description

"wall_insulation: 2 is not allowed for build_year: 2010. Allowed values: [4]. Set wall_insulation: 4."

address

house_number

1

House number

address

post_code

1234AB

Zipcode

address

addition

A

House number addition

address

street

Dorpstraat

Street name

address

city

Amsterdam

City name

address

location.lat

52.06839

Coordinates

address

location.lon

4.65808

Coordinates

building

build_year

2001

Construction year

building

inner_surface

120

Square meters livable space

building

floor_surface

73

Square meters floor

building

flat_roof_surface

18

Square meters flat roof

building

pitched_roof_surface

81

Square meters pitched roof

building

wall_surface

113

Square meters wall

building

glass_living_room_surface

24

Square meters glass livingroom

building

glass_bedrooms_surface

6

Square meters glass bedrooms

building

number _of_doors

5

Number of doors

building

type

Vrijstaand

The house type

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

comfortscore

current

1

comfortscore

potential

5

CO2

current

10000

see CO2

CO2

potential

5000

see CO2

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

energy_cost_monthly.current

235

monthly costs in €

financial

energy_cost_monthly.potential

228

monthly costs in €

financial

energy_cost_yearly.current

2817

yearly costs in €

financial

energy_cost_yearly.potential

2737

yearly costs in €

financial

return_on_investment

1.12%

financial

loan:monthly_payment

111

monthly payment in € when financing

gas_usage

current

1379

estimated or given gas usage in m^3/year

gas_usage

potential

1305

estimated new situation usage in m^3/year

electricity_usage

current

4077

estimated or given electricity usage in kWh/year

electricity_usage

potential

1000

estimated new situation electricity usage in kWh/year

city_heating

current

1909

estimated or given city heating usage in GJ/year

city_heating

potential

1036

estimated new situation city heating usage in GJ/year

solar_panel_yield

current

solar_panel_yield

potential

solar_panels

current

solar_panels

potential

measures

wall_insulation

measures

floor_insulation

measures

sloped_roof_insulation

measures

flat_roof_insulation

measures

measuresliving_room_windows

measures

bedroom_windows

measures

ventilation

measures

solar_panels

measures

installation

measures

shower

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

savings

1107

yearly savings in energy costs as a result of the specific measure

co2_reduce

2541

see CO2

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

{
  "warnings": [
    {
      "code": "05",
      "description": "heat_usage is not allowed with installation: 4. heat_usage is ignored."
    },
    {
      "code": "50",
      "description": "target_ventilation: 3 is not a valid improvement measure from level 1. Calculated investment costs with value set to 4."
    }
  ],
  "address": {
    "housenumber": 87,
    "postcode": "2771DS",
    "houseaddition": null,
    "street": "Zuidkade",
    "city": "Boskoop",
    "location": {
      "lat": 52.06839381665532,
      "lon": 4.65808526945334
    }
  },
  "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": "F",
    "potential": "A"
  },
  "provided_label": {
    "temporary": "F",
    "definitive": "C",
    "definitive_type": null,
    "definitive_validity": null
  },
  "BENG1": {
    "current": null,
    "potential": null
  },
  "BENG2": {
    "current": 337,
    "potential": 153
  },
  "meta": null,
  "energyindex": {
    "current": null,
    "potential": null
  },
  "ELG": {
    "current": null,
    "potential": null
  },
  "comfortscore": {
    "current": null,
    "potential": null
  },
  "CO2": {
    "current": 4037,
    "potential": 3265
  },
  "financial": {
    "total_investment": 68215,
    "total_saving": 580,
    "months_to_pay_off": 1411,
    "eco_value": 42243,
    "savings_monthly": 48,
    "energy_cost_monthly": {
      "current": 262,
      "potential": 214
    },
    "energy_cost_yearly": {
      "current": 3150,
      "potential": 2570
    },
    "return_on_investment": "-0.81%",
    "loan": {
      "monthly_payment": 282
    }
  },
  "gas_usage": {
    "current": 800,
    "potential": 1165
  },
  "electricity_usage": {
    "current": 3000,
    "potential": 3576
  },
  "city_heating_usage": {
    "current": 0,
    "potential": 0
  },
  "solar_panel_yield": {
    "current": 100,
    "potential": 100
  },
  "energy_prices": {
    "variable_gas_price": null,
    "variable_electricity_price": null,
    "solarpanel_watt_peak_per_m2": null
  },
  "solar_panels": {
    "current": null,
    "potential": null
  },
  "measures": {
    "wall_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 2
      },
      "after": {
        "desc": "Goed",
        "value": 3,
        "points": 5
      },
      "investment": 20302,
      "savings": 165,
      "co2_reduce": 217,
      "BENG2": "38",
      "gas_savings": -787,
      "electricity_savings": 15
    },
    "floor_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Zeer goed",
        "value": 4,
        "points": 7
      },
      "investment": 4832,
      "savings": 18,
      "co2_reduce": 24,
      "BENG2": "6",
      "gas_savings": -892,
      "electricity_savings": 2
    },
    "sloped_roof_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Goed",
        "value": 3,
        "points": 3
      },
      "investment": 18766,
      "savings": 49,
      "co2_reduce": 64,
      "BENG2": "14",
      "gas_savings": -871,
      "electricity_savings": 5
    },
    "flat_roof_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Goed",
        "value": 3,
        "points": 3
      },
      "investment": 484,
      "savings": 1,
      "co2_reduce": 1,
      "BENG2": "0",
      "gas_savings": -905,
      "electricity_savings": 0
    },
    "living_room_windows": {
      "before": {
        "desc": "Enkel glas",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "HR++ glas",
        "value": 3,
        "points": 2
      },
      "investment": 2400,
      "savings": 18,
      "co2_reduce": 24,
      "BENG2": "6",
      "gas_savings": -893,
      "electricity_savings": 2
    },
    "bedroom_windows": {
      "before": {
        "desc": "Enkel glas",
        "value": 1,
        "points": null
      },
      "after": {
        "desc": "HR++ glas",
        "value": 3,
        "points": null
      },
      "investment": 3589,
      "savings": 30,
      "co2_reduce": 40,
      "BENG2": "9",
      "gas_savings": -884,
      "electricity_savings": 3
    },
    "installation": {
      "before": {
        "desc": "HR-combi ketel",
        "value": 4,
        "points": 15
      },
      "after": {
        "desc": "HR combi met zonneboiler",
        "value": 5,
        "points": 15
      },
      "investment": 5766,
      "savings": 17,
      "co2_reduce": 23,
      "BENG2": "7",
      "gas_savings": -889,
      "electricity_savings": -20
    },
    "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": "Air conditioning unit",
        "value": 2,
        "points": null
      },
      "investment": 2350,
      "savings": -24,
      "co2_reduce": -30,
      "BENG2": "0",
      "gas_savings": -906,
      "electricity_savings": -89
    },
    "ventilation": {
      "before": {
        "desc": "Natuurlijk",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Gebalanceerd",
        "value": 3,
        "points": 10
      },
      "investment": 8226,
      "savings": -19,
      "co2_reduce": -20,
      "BENG2": "16",
      "gas_savings": -861,
      "electricity_savings": -295
    },
    "solar_panels": {
      "before": {
        "desc": "0",
        "value": 0,
        "points": null
      },
      "after": {
        "desc": "0",
        "value": 0,
        "points": null
      },
      "investment": 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": "Electric stove",
        "value": 2,
        "points": null
      },
      "investment": 1500,
      "savings": -47,
      "co2_reduce": -59,
      "BENG2": "0",
      "gas_savings": -906,
      "electricity_savings": -175
    }
  },
  "response_meta": null
}

Last updated