Output interpretation

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

Category	Feature	Example	Explanation
warnings	code	03	see Warnings
warnings	description	"wall_insulation: 2 is not allowed for build_year: 2010. Allowed values: [4]. Set wall_insulation: 4."	see Warnings
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
label	potential	A	see Energylabel
	accuracy_indicator	6	see Accuracy indicator
provided_label	temporary	C	see Energylabel
provided_label	definitive	A+	see Energylabel
provided_label	definitive_type	NTA8800	see Energylabel
provided_label	definitive_validity	31-12-2030	see Energylabel
provided_label	definitive_beng2	49	see Energylabel
BENG2	current	200	see Energylabel
BENG2	potential	50	see Energylabel
	meta	null	to be ignored
CO2	current	10000	see CO2
CO2	potential	5000	see CO2
grid_import	current	1405	Annual electricity from the electricity grid in kWh
grid_import	potential	2058	Annual electricity from the electricity grid in kWh
grid_feed	current	0	Annual electricity to the electricity grid in kWh
grid_feed	potential	2808	Annual electricity to the electricity grid in kWh
electricity_need	current	1405	Annual electricity demand in kWh
electricity_need	potential	0	Annual electricity demand in kWh
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	electricity_cost_yearly.current	1886	yearly electricity costs in €
financial	electricity_cost_yearly.potential	1432	yearly electricity 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_panels	systems.current		see Measures
solar_panels	systems.potential		see Measures
battery	current		see Measures
battery	potential		see Measures
measures	wall_insulation		see Measures
measures	floor_insulation		see Measures
measures	sloped_roof_insulation		see Measures
measures	flat_roof_insulation		see Measures
measures	measuresliving_room_windows		see Measures
measures	bedroom_windows		see Measures
measures	ventilation		see Measures
measures	solar_panels		see Measures
measures	installation		see Measures
measures	shower		see Measures
	for every measure
	before:desc	Geen	see Measures
	before:value	0	see Measures
	before:points	0
	after:desc	Zeer goed	see Measures
	after:value	3	see Measures
	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": [],
  "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
}