🇬🇧
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
  1. API's
  2. Sustainability API

Output interpretation

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

Feature
Example
Explanation

house_number

1

House number

post_code

1234AB

Zipcode

addition

A

House number addition

street

Dorpstraat

Street name

city

Amsterdam

City name

location (lat/lon)

52.06839 / 4.65808

GPS coördinates

build_year

2001

Construction year

inner_surface

120

Square meters livable space

floor_surface

73

Square meters floor

flat_roof_surface

18

Square meters flat roof

pitched_roof_surface

81

Square meters pitched roof

wall_surface

113

Square meters wall

glass_living_room_surface

24

Square meters glass livingroom

glass_bedrooms_surface

6

Square meters glass bedrooms

type

Vrijstaand

House type: '2 onder 1 kap' 'hoekwoning', 'tussenwoning', 'vrijstaand' or 'appartment'

label:current

G

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

energyindex:current

null

legacy feature, defunct

energyindex:potential

null

legacy feature, defunct

ELG:current

null

legacy feature, defunct

ELG:potential

null

legacy feature, defunct

comfortscore:current

1

comfortscore:potential

5

CO2:current

10000

CO2:potential

5000

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:loan:monthly_payment

111

monthly payment in € when financing

usage:gas

6059

estimated or given gas usage in m3 per year

usage:energy

4077

estimated kWh per year

usage:city_heating

1000

estimated GJ per year

usage_potential:gas

1909

estimated new situation usage in m3 per year

usage_potential:energy

1036

estimated new situation usage in kWh per year

usage_potential:city_heating

1000

estimated new situation usage in GJ per year

energy_price:variable_gas_price

0.774

gas price per m3 used for calculations

energy_price:variable_electricity_price

0.223

electricity price per kWh used for calculations

energy_price:solarpanel_watt_peak_per_m2

212

watt peak performance used for solar panels

measures:wall_insulation

see for every measure

measures:floor_insulation

see for every measure

measures:roof_insulation

see for every measure

measures:living_room_windows

see for every measure

measures:bedroom_windows

see for every measure

measures:ventilation

see for every measure

measures:solar_panels

see for every measure

measures:instalation

see for every measure

measures:shower

see for every measure

for every measure

before:desc

Geen

before:value

0

before:points

0

after:desc

Zeer goed

after:value

3

after:points

7

investment

2994.39

cost of investment for the specific measure

saving

1107

yearly savings in energy costs as a result of the specific measure

co2_reduce

2541

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

{
	"address": {
		"house_number": 87,
		"post_code": "2771DS",
		"addition": null,
		"street": "Zuidkade",
		"city": "Boskoop",
		"location": {
			"lat": 52.06839381665532,
			"lon": 4.6580852694533394
		}
	},
	"building": {
		"build_year": 1961,
		"inner_surface": 131.0,
		"floor_surface": 97.0,
		"flat_roof_surface": 0,
		"pitched_roof_surface": 124.4,
		"wall_surface": 150.7,
		"glass_living_room_surface": 24.9,
		"glass_bedrooms_surface": 6.9,
		"type": "vrijstaand"
	},
	"label": {
		"current": "G",
		"potential": "A++++"
	},
	"provided_label": {
		"temporary": "F",
		"definitive": "C",
		"definitive_type": null,
		"definitive_validity": null
	},
	"BENG1": {
		"current": 165,
		"potential": 139
	},
	"BENG2": {
		"current": 422,
		"potential": -1
	},
	"meta": null,
	"energyindex": {
		"current": null,
		"potential": null
	},
	"ELG": {
		"current": null,
		"potential": null
	},
	"comfortscore": {
		"current": 1,
		"potential": 3
	},
	"CO2": {
		"current": 10632,
		"potential": 2564
	},
	"financial": {
		"total_investment": 67638.64,
		"total_saving": 8119.28,
		"months_to_pay_off": 99,
		"eco_value": null,
		"savings_monthly": 677,
		"energy_cost_monthly": 681,
		"loan": {
			"monthly_payment": 280.0
		}
	},
	"usage": {
		"gas": 6059,
		"energy": 4077,
		"city_heating": 0
	},
	"usage_potential": {
		"gas": 0,
		"energy": 903,
		"city_heating": 0
	},
	"energy_prices": {
		"variable_gas_price": 1.144,
		"variable_electricity_price": 0.293,
		"solarpanel_watt_peak_per_m2": 212
	},
	"measures": {
		"wall_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 2
			},
			"after": {
				"desc": "Geen",
				"value": 0,
				"points": 2
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"floor_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2,
				"points": 7
			},
			"investment": 2865.38,
			"saving": 1426,
			"co2_reduce": 2223,
			"BENG2": "20.8%",
			"gas_savings": 1205,
			"electricity_savings": 161
		},
		"roof_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2,
				"points": 3
			},
			"investment": 12441.24,
			"saving": 1928,
			"co2_reduce": 3005,
			"BENG2": "28.1%",
			"gas_savings": 1629,
			"electricity_savings": 218
		},
		"living_room_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": 1
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": 1
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"bedroom_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": null
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": null
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"ventilation": {
			"before": {
				"desc": "Natuurlijk",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Natuurlijk",
				"value": 0,
				"points": 0
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"solar_panels": {
			"before": {
				"desc": "0",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "59",
				"value": 59,
				"points": null
			},
			"investment": 21849.7,
			"saving": 3279,
			"co2_reduce": 3705,
			"BENG2": "19%",
			"gas_savings": 0,
			"electricity_savings": 11192
		},
		"instalation": {
			"before": {
				"desc": "HR-combi",
				"value": 4,
				"points": 15
			},
			"after": {
				"desc": "WP bodem combi",
				"value": 7,
				"points": 20
			},
			"investment": 29686.14,
			"saving": 2665,
			"co2_reduce": 4254,
			"BENG2": "64.0%",
			"gas_savings": 6059,
			"electricity_savings": -15438
		},
		"shower": {
			"before": {
				"desc": "Geen Douche WTW",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "Douche WTW",
				"value": 1,
				"points": null
			},
			"investment": 796.18,
			"saving": 93,
			"co2_reduce": 146,
			"BENG2": "0.4%",
			"gas_savings": 82,
			"electricity_savings": 0
		}
	},
	"response_meta": null
}
PreviousExample API callsNextIncreasing energy costs

Last updated 23 days ago

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page

see page, per year

CO2
Energylabel
Energylabel
Energylabel
Energylabel
Energylabel
Energylabel
Energylabel
Energylabel
Energylabel
Energylabel
Comfortscore
Comfortscore
CO2
CO2
Measures
Measures
Measures
Measures
Measures
Measures
Measures
Measures
Measures
Measures
Measures
Measures
Comfortscore
Measures
Measures
Comfortscore