🇬🇧
Altum AI
StartPlatformMonitorAltum AIContact
English
English
  • Altum AI API documentation
  • Platform
    • Monthly subscriptions
    • Yearly subscriptions
    • Unlimited usage subscriptions
    • Kadaster Transaction API subscription
    • Changelog
  • Updates
  • Developers
    • Perform your first API call
    • Credit API
    • Sandbox
    • OpenAPI specifications
    • GET API status
  • Altum AI website
  • Pricing
  • Property AI
    • Authentication, Input, and Response
    • Output Interpretation
    • FAQs
  • API's
    • AVM API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • Accuracy Indicator
      • House numbers & additions
      • House types
      • Variables
      • Output interpretation
      • Frequently Asked Questions (FAQ)
    • AVM+ API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • House numbers, letters & additions
      • Energylabel and Inner and Outer Surface Area
      • Output interpretation
    • Listing Price API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • House numbers, letters & additions
      • Inner and Outer Surface Area
      • Output interpretation
    • Sustainability API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • Energylabel
      • Improving the advice
      • Example API calls
      • Output interpretation
      • Increasing energy costs
      • Exclude measures
      • Search criteria
      • Measures
      • Insulation values
      • Comfort score
      • CO2
      • Coverage
      • Cost table input
      • Frequently Asked Questions (FAQ)
    • NTA 8800 Energylabel API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • EPC API
      • Changelog
      • API Key Information
      • Authentication, input and response
      • Output Interpretation
    • Energylabel insights API
      • ChangeLog
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • WOZ API
      • Changelog
      • Frequently Asked Questions (FAQ)
      • Authentication, input and response
      • API Key Information
      • Output interpretation
      • PC6 average WOZ value
    • Interactive Reference API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • Visual similarity search
      • House types
      • Comparable functions
      • Output interpretation
    • Kadaster Transaction API
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Housing features API
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Contents Value API
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Building geometry API
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Energy & climate API
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Condition score API
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Photo Labelling API
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Autosearch API
      • Authentication, input and response
      • API Key Information
    • Autosuggest API
      • Authentication, input and response
      • API Key Information
      • Fuzzy Search Support
      • Output interpretation
    • Move data API
      • ChangeLog
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Location Data API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • House types
      • Output interpretation
    • Rental Reference API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Rebuild Value API
      • Changelog
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • Solar panel roof scan API
      • Authentication, input and response
      • API Key Information
      • Output interpretation
    • WWS Points API
      • Authentication, input and response
      • API Key Information
      • Specifications for independent home version 01-01-2024
      • Specifications for non-independent home version 01-01-2024
      • Specifications for independent home version 01-07-2024
      • Specifications for non-independent home version 01-07-2024
      • Input explanation for version 01-07-2024
      • Output interpretation
  • API error codes
    • 429
    • 422
    • 403
Powered by GitBook
On this page
  • Use the functions for the best possible sustainability advice
  • Questioning the home owner for the current situation and energy usage
  • Questioning current measures
  • Preferences of the customer
  • Preferences of the provider
  • Presentation of the advice
  1. API's
  2. Sustainability API

Improving the advice

The Sustainability API offers a lot of functions to improve the output from customers- and/or suppliers perspective. This page explains the different functions

Use the functions for the best possible sustainability advice

  1. Questioning the home owner for the current situation and energy usage

    1. Property details

    2. Measures taken

  2. Preferences of the home owner

  3. Preferences of the provider

  4. Presentation of the sustainability advice

Questioning the home owner for the current situation and energy usage

Home data and consumption Postal Code * House number * House number addition Surface area (m2) House type Construction year Inhabitants Gas usage (m3) Electricity usage (kWh) City heating heat consumption

"post_code": "2771DS", "house_number": "87", "addition": "A", "inner_surface_area": 130, "house_type": 1, "build_year": 2000, "inhabitants": 3, "gas_usage": 3000, "electricity_usage": 3500, "heat_usage": null

Explanation

The address is used to request all home data and to make estimates with regard to current measures and consumption. It is possible, but not required, to overwrite the surface area (residential usable area), the housing type, year of construction, number of inhabitants and cubic gas consumption.

* is required

Questioning current measures

Present solar panels Existing installation Present insulation windows Existing insulation floor, facade and roof Existing ventilation Present shower HRV

"solar_panels": 10, "installation": 4, "bedroom_windows": 1, "living_room_windows": 1, "wall_insulation": 1, "roof_insulation": 1, "floor_insulation": 1, "ventilation": 0, "shower": 0,

Explanation

With the year of construction, housing type, gas consumption and the surface area known, an estimate is made of the current measures in place. It is possible to overwrite this to generate an advice that is more in line with the current situation of the property.

Preferences of the customer

Exclude measure in advice Maximum budget Target energy label as a minimum Boiler replacement is allowed Recommend heat pump Search criteria sustainability Gas consumption allowed Roof utilization for solar panels

“lock_measures”: {“lock”: [“wall_insulation”]}, “max_investment”: 20000, “target_label”: “A”, “replace_boiler”: true, “heat_pump_allowed”: true, “search_criteria”: 1, “natural_gas”: 0, “solar_panels_surface”: 1,

Explanation

It is possible to lock measures so that they are not included in the advice. Indicate whether the boiler may be replaced and whether a heat pump may be recommended. A maximum budget or the goal of sustainability can be taken into account: best return, lowest investment costs, lowest energy bill or best energy label. It is also possible to exclude natural gas consumption and to indicate to what extent the roof may be used for solar panels.

Preferences of the provider

Exclude sub-measure in advice Strict search within target energy label Show number of panels or wattage Minimum number of solar panels advice Only heat pump from certain insulation level Cost figures Cost table

“exclude_measure”: [8004,8005], “energylabel_strict”: 1, “watt_panels”: false, “minimum_solar_panels”: 5, “heatpump_insulation_req”: 2, “custom_costs”: [{“code”: 3, “value”: 0.8}], “improvement_costs": [{"code": 10001,"material": 15,"work": 10, "saving_material": 14,"saving_work": 9}]

Explanation In addition to locking entire measures, a sub-measure such as the biomass boiler can also be excluded. It is also possible to search strictly within one energy label as a target. By default we show the number of solar panels as output, but wattage is also possible. You can also enforce the minimum number of solar panels that are recommended. Just like from which insulation level a heat pump is recommended. Finally, it is possible to overwrite all used installation costs and cost indicators such as VAT and energy prices.

Presentation of the advice

Estimated energy label current & new Eco value: market value increase Investment required CO2 reduction Investment, savings CO2 reduction and BENG2 impact in % per measure Current definitive energy label (RVO)

"label": {"current": "G", "potential": "A"}, "eco_value": 37087.0, "total_investment": 28597.3, "CO2": {"current": 10632,"potential": 4099}, "investment": 2994.39,"saving": 1107, "co2_reduce": 2541, "BENG2": "23.8%", "definitive": "C", "definitive_type": NTA8800,"definitive_validity": 05072031},

Explanation The API makes an estimate of the current and new energy label based on. the NTA 8800. A calculation is made of the increased market value after sustainability. The required costs and CO2 reduction are also shown in total, as well as the relative impact on the energy label for each measure. The definitive energy label is collected from the RVO.

PreviousEnergylabelNextExample API calls

Last updated 4 months ago