Ecovalue API

Quering the Ecovalue API for a Dutch home gives the sustainability measures and Ecovalue market value increase


With the Ecovalue, Altum AI creates a unique insight into sustainability measures and correlated property value consequences ​​for homes in the Netherlands. The source for calculating the Ecovalue of a home is the so-called Automated Valuation Model (AVM) of Altum AI. This model works with more than 150 variables per house that update in real-time. Consider known variables such as year of construction, inner surface area, volume, parcel area. The Ecovalue is the delta value of a home after specific sustainability measures apply correlated with an Energylabel increase. The Ecovalue API also provides the necessary measures, combined with the investments and savings in Euros and CO2 per measure.

This version of the Ecovalue API will deprecate on 30-9-2021 as the EBVW webservice from RVO will be shutdown. Altum AI is developing an alternative on the new NTA 8800 norm to be able to continue delivering this product.

Demo Ecovalue API

How to use

To be able to deliver sustainability measures, the Ecovalue, the investments, and savings, we need to identify the object based on the zip code and house number. It is then possible to give more input, such as a budget to be able to return the most optimal investments, the desired target energy label to know what needs to be done to reach this label. Enter the current gas usage to give a better estimate and give measures that already have been taken by the homeowner, which needs to exclude in the response. These are not required to generate a response.

Depending on the object, house-type, and input, we generate a response. This response covers the details about the home, such as the address, building type, building year, inner surface area, and if available current energy label. Then we show a full financial statement based on possible measures (depending on if items are locked and if it fits within a specific budget) with the expected investment, total savings, and how many months it takes to earn it back if applicable. Besides that, we calculate the possible Ecovalue home value increase after these measures apply. It also covers the cost of a monthly loan to cover the costs of the investment. We give an estimate of energy and gas usage. After that, we generate a breakdown of the measures in terms of total expenditure and expected yearly savings. Per measure, we show an impact on CO2 reduction in kgs and wattage output. We do not incorporate subsidies into the financing of the measures.

Customer journey optimization

The Ecovalue API uses defaults to give an output based on minimal input. To increase the accuracy of outcome in regards to the current situation of the object you can provide more information. If necessary or desired it is also possible to include or prefer some measures over others to adjust the outcome.

Object & goal
Current situation
Adjusted outcomes
Object & goal
  • Postcode & house number details

  • Target energy label

  • Budget (default: unconstrained)

Current situation
  • Inner surface area (default: source BAG/Kadaster)

  • Inhabitants (default: 2)

  • Gas usage (default: RVO calculation)

Adjusted outcomes
  • Locking of measures (default: ventilation)

  • Output variant (default: medium)

  • Replace boiler possible (default: no)

  • Heat pump allowed (default: yes)

  • Search criteria (default: highest financial ROI)

  • Search options (default: same or worse allowed)

  • Solar panels surface (default: roof maximum covered)


The Ecovalue is the expected market value increase after sustainability measures apply and an energylabel change is present. For example a house which goes from D to A with solar panels, a heat pump and insulation. The Ecovalue takes into account local variety in and whether the label changes to B or A. Changing to energylabel A increases the market value more than changing to B.

Input & input

Up next: