Sustainability API v2
Querying the Sustainability API for a Dutch home gives the sustainability measures and Ecovalue market value increase.
Introduction
The Sustainability v2 API remains Altum AI's cutting-edge solution for delivering precise, data-driven sustainability insights for Dutch residential properties. Built on the latest NTA 8800 methodology, the API returns the current and resulting energy label, energy use, energy costs, CO2 emissions, investment, savings and return on investment, all while maintaining GDPR compliance.
The API supports installers, energy advisers, real estate agents, appraisers and banks in making informed, sustainable decisions across the Dutch housing market.
Apartments use the separate Sustainability API v2 for Apartments.
What's new in Sustainability v2: Enhanced capabilities for precision and scale
v2 extends v1 strengths with more detailed inputs about the home, its energy contract and the measures you want to consider. All fields are listed on Authentication, input and response.
The main changes:
Refined property inputs for accuracy. New inputs include roof type (sloped and flat), cooling and electric cooking. Installers can match heating, cooling and solar advice more closely to the home. Appraisers can adjust the input to the specific property.
Energy contract, solar panels and battery. The calculation includes, solar panels per roof surface with orientation, inclination and free roof area, the electricity contract (fixed or dynamic), connection type, EV charger, the netting scheme and an optional home battery. The response shows self-consumption and grid feed-in.
NTA 8800 update. Reflects latest refinements, prioritizing primary fossil energy and renewable shares for BENG compliance. This ensures alignment with EU EPBD and Dutch near-zero energy goals.
Want to calculate the effect of measures you have already chosen? Use the Sustainability API v2 Delta for Houses. It compares the current situation with a target situation you define.
Core Features: Building on Proven Strengths
Energy label estimates. The current and resulting label, calculated with a simplified NTA 8800 method. Where the home has a registered label, the response also returns it, so you can compare both.
Financial insights. Investment, yearly and monthly savings, payback period, return on investment and an indicative monthly loan payment. Subsidies are not included.
Ecovalue. The expected change in market value when the label improves, calculated with Altum AI's valuation model AVM.
Sustainability metrics. CO2 emissions and reduction, gas, heat and electricity use, and solar generation.
BENG 2 classification. Labels from A++++ to G, following the legal classification (see BENG 2.0 norm).
Use Cases: Tailored for Dutch Housing Professionals
Installers and energy advisers. Enter what you saw during the site visit, such as insulation levels and the current installation, and add your own measure costs, cutting proposal time by 40%. The API then calculates a package that fits the home and your prices.
Real estate agents. Show buyers what improving a home involves and what it does for the label and energy costs, boosting sales velocity.
Appraisers. Explore the label and value effect of measures alongside a valuation.
Banks. Model the effect of measures on label and energy costs within a customer portal or advice tool, for example for green mortgages or extra borrowing for energy-saving measures, aligning with NHG standards.
NTA 8800
The Sustainability v2 API has the NTA 8800 Energylabel v2 API integrated, which is designed to provide accurate and reliable energy label estimates for buildings. Inside the Sustainability v2 API it determines the current situation of the home, which is the starting point for the advice. By integrating this API with our Sustainability v2 API, we aim to enhance the precision and usefulness of our energy efficiency assessments.
The energy label is estimated with the NTA 8800 method, based on building characteristics derived from various data sources, the Building Decree and, where provided, user input. This makes it possible to estimate a label under the current norm from address data alone, and to refine it with characteristics you know. In some cases a home has installations that are not part of the model, or a living area that differs strongly from standard dimensions. For these homes the estimated label is expected to be less accurate.
The performance of the estimated label is published on the page of the NTA 8800 Energylabel v2 API for Houses. The same accuracy_indicator is returned in each response of this API, so you can judge the result for each individual home.
Target energy label
The target energy label is a minimum, not a maximum. When you ask for label A, the API can return A+ or better, depending on the search criterion. To stay within the target label, set energylabel_strict to 1. You can also limit the outcome with a maximum investment, or choose the lowest investment costs as search criterion.
How to use
The API identifies the home by postcode , housenumber and houseaddtion. That is all you need for a response. You can add more input to improve the result or steer the advice: a budget, a target label, the actual gas, heat or electricity use, the current state of insulation and installations, measures that have already been taken or should not be proposed, measure filters and custom costs.
The response describes the home (address, house type, construction year, surfaces and, if available, the registered energy label). It then gives a financial overview of the proposed package: investment, savings, payback period, return on investment and an indicative monthly loan payment. It adds the Ecovalue, the expected energy use before and after, and per measure the investment, savings, CO2 reduction and effect on BENG2. For solar panels and batteries it shows generation, self-consumption and grid feed-in.
BENG 2.0 norm

A++++
≤ 0,00
A+++
0,01 - 50.00
A++
50.01 - 75.00
A+
75.01 - 105.00
A
105.01 - 160.00
B
160.01 - 190.00
C
190.01 - 250.00
D
250.01 - 290.00
E
290.01 - 335.00
F
335.01 - 380.00
G
> 380.00
Customer journey optimization
The API uses defaults so it can respond on minimal input. Add what you know about the home to make the current situation more accurate, and use the filters to include or exclude measures.
Address details (postcode, housenumber, houseaddition)
Target energy label (target_label)
Budget (max_investment)
Building chacteristics (inner_surface_area, build_year, roof_type, ...)
Measures (wall_insulation, installation, solar_panels, battery_type...)
Usage (gas_usage, electricity_usage, ...)
Locking measures (lock_measures)
Excluding measures (exclude_measures)
Search criteria (search_criteria)
Filters (wall_filters, floor_filters, ...)
Allowed (heat_pump_allowed, district_heating_allowed)
Customs costs (cost_indicators)
VAT (exclude_vat)
Ecovalue
The Ecovalue is the expected market value increase when sustainability measures lead to a better energy label. An example is a home that goes from label D to A with solar panels, a heat pump and insulation. The Ecovalue takes local market differences into account, and the size of the label step: a step to A generally adds more value than a step to B.
The Ecovalue is calculated with Altum AI's automated valuation model AVM. This model works with more than 150 variables per home that update in real-time. The Ecovalue is the difference between the value with the current label and the value with the resulting label. It is an indication, not a valuation. Set eco_delta to 0 if you do not need it.
POST Method

Up next:
Authentication, input and responseLaatst bijgewerkt
