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

see Energylabel page

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

see Comfortscore TBA

comfortscore

potential

5

see Comfortscore TBA

CO2

current

10000

see CO2 page

CO2

potential

5000

see CO2 page

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

see Measures page

measures

floor_insulation

see Measures page

measures

sloped_roof_insulation

see Measures page

measures

flat_roof_insulation

see Measures page

measures

measuresliving_room_windows

see Measures page

measures

bedroom_windows

see Measures page

measures

ventilation

see Measures page

measures

solar_panels

see Measures page

measures

installation

see Measures page

measures

shower

see Measures page

for every measure

before:desc

Geen

see Measures page

before:value

0

see Measures page

before:points

0

see Comfortscore page

after:desc

Zeer goed

see Measures page

after:value

3

see Measures page

after:points

7

see Comfortscore page

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 page, per year

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": [],
  "address": {
    "postcode": "2771DS",
    "housenumber": 87,
    "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": "C",
    "potential": "A++++"
  },
  "provided_label": {
    "temporary": "F",
    "definitive": "C",
    "definitive_type": null,
    "definitive_validity": null
  },
  "BENG1": {
    "current": null,
    "potential": null
  },
  "BENG2": {
    "current": 197,
    "potential": -86
  },
  "meta": null,
  "energyindex": {
    "current": null,
    "potential": null
  },
  "ELG": {
    "current": null,
    "potential": null
  },
  "comfortscore": {
    "current": null,
    "potential": null
  },
  "CO2": {
    "current": 1969,
    "potential": -941
  },
  "financial": {
    "total_investment": 81534,
    "total_saving": 1346,
    "months_to_pay_off": 726,
    "eco_value": 10398,
    "savings_monthly": 112,
    "energy_cost_monthly": {
      "current": 196,
      "potential": 84
    },
    "energy_cost_yearly": {
      "current": 2355,
      "potential": 1009
    },
    "return_on_investment": "-0.59%",
    "loan": {
      "monthly_payment": 338
    }
  },
  "gas_usage": {
    "current": 405,
    "potential": 365
  },
  "electricity_usage": {
    "current": 3612,
    "potential": 8798
  },
  "city_heating_usage": {
    "current": 0,
    "potential": 0
  },
  "solar_panel_yield": {
    "current": 6153,
    "potential": 13485
  },
  "energy_prices": {
    "variable_gas_price": null,
    "variable_electricity_price": null,
    "solarpanel_watt_peak_per_m2": null
  },
  "solar_panels": {
    "current": [
      {
        "roof_surface": 0,
        "roof_type": null,
        "original_watt_peak_capacity": null,
        "total_watt_peak_capacity": 4200,
        "added_watt_peak_capacity": null,
        "added_panels": null,
        "inclination_angle": 35,
        "orientation": 180
      },
      {
        "roof_surface": 1,
        "roof_type": null,
        "original_watt_peak_capacity": null,
        "total_watt_peak_capacity": 2724,
        "added_watt_peak_capacity": null,
        "added_panels": null,
        "inclination_angle": 35,
        "orientation": 180
      }
    ],
    "potential": [
      {
        "roof_surface": 0,
        "roof_type": "sloped",
        "original_watt_peak_capacity": 4200,
        "total_watt_peak_capacity": null,
        "added_watt_peak_capacity": 4125,
        "added_panels": 10,
        "inclination_angle": 35,
        "orientation": 180
      },
      {
        "roof_surface": 1,
        "roof_type": null,
        "original_watt_peak_capacity": 2724,
        "total_watt_peak_capacity": null,
        "added_watt_peak_capacity": 4125,
        "added_panels": 10,
        "inclination_angle": 35,
        "orientation": 180
      }
    ]
  },
  "measures": {
    "wall_insulation": {
      "before": {
        "desc": "Matig",
        "value": 2,
        "points": 5
      },
      "after": {
        "desc": "Goed",
        "value": 3,
        "points": 5
      },
      "investment": 19722,
      "savings": 78,
      "co2_reduce": 104,
      "BENG2": "7",
      "gas_savings": 8,
      "electricity_savings": 4
    },
    "floor_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Zeer goed",
        "value": 4,
        "points": 7
      },
      "investment": 5854,
      "savings": 38,
      "co2_reduce": 50,
      "BENG2": "4",
      "gas_savings": 4,
      "electricity_savings": 2
    },
    "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
    },
    "ventilation": {
      "before": {
        "desc": "Natuurlijk",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Decentraal mechanisch",
        "value": 4,
        "points": 5
      },
      "investment": 6354,
      "savings": 89,
      "co2_reduce": 44,
      "BENG2": "12",
      "gas_savings": 16,
      "electricity_savings": -447
    }
  },
  "response_meta": null
}

Last updated