Specifications for independent home version 01-01-2026

The following information describes the inputs required for each rule in the WWS calculation according to the 01-01-2026 rules. This ensures correct and consistent data entry into the API for accurate

1. Independent Homes (Type A)

Endpoint: POST https://api.altum.ai/wws/01012026

* : means this feature is mandatory; otherwise, it is optional.

1.1 Root Object Parameters

Parameter	Type	Description	Allowed Values
house_type *	String	Type of the dwelling.	Eengezinswoning, Meergezinswoning, Duplexwoning
build_year *	Integer	Year of construction.	e.g., 1995, 2022
woz_valuation_year *	Integer	Reference year for WOZ value.	2024, 2025, 2026
corop_area_amsterdam_or_utrecth *	Boolean	Is the property in Amsterdam/Utrecht COROP region?	true, false
woz_value	Float	The determined WOZ value (€).	≥ 0
usable_surface_area	Float	Total usable surface area (m²).	≥ 0
contract_start_date	String	Lease start date (ISO 8601). Affects monument point calculation (pre/post July 2024).	YYYY-MM-DD
energy_label	String	Official energy label.	A++++, A+++, A++, A+, A, B, C, D, E, F, G, ""
energy_index_existence	Boolean	Whether an energy index value is provided.	true, false
energy_index	Float	Energy index value (used if no label available).	≥ 0
energy_performance_compensation	Boolean	EPV (Energieprestatievergoeding) applies. Overrides label/index points.	true, false
monument	String	Monument status.	national, municipal, provincial, ""
care_home	Boolean	Is it a designated care home (Zorgwoning)? Adds 35% uplift.	true, false
doorbell	Boolean	Presence of a video doorbell (+0.25 pts).	true, false
disability_costs	Float	Net investment costs for disability adaptations (€). 1 pt per €332.	≥ 0
rooms	List	List of Room objects. See §1.2 Rooms.	—
kitchen	List	List of Kitchen objects. See §1.2 Kitchen.	—
sanitary	List	List of Sanitary objects. See §1.2 Sanitary.	—
toilet	List	List of Toilet objects. See §1.2 Toilet.	—
outdoor	List	List of Outdoor objects. See §1.2 Outdoor. No entry = -5 pts penalty.	—
parking	List	List of Parking objects. See §1.2 Parking.	—
disabled_people	Integer	Number of disabled occupants.	≥ 0

1.2 Nested Objects

rooms (List)

Living rooms, bedrooms, hallways, storage spaces, attics, etc.

Field	Type	Description
type_of_room *	String	room (living/bedroom counts as vertrek) or other (storage/hall counts as overige ruimte)
surface_area	Float	Area in m²
shared_addresses	Integer	Number of dwellings sharing this space
heated	Boolean	Is the room heated? (+2 pts for vertrek, +1 pt for overige ruimte)
cooled	Boolean	Is the room cooled? (+1 pt, only for vertrekken, capped at 2 pts total)
attic_without_fixed_staircase	Boolean	Attic accessible by ladder only — applies a 5 pt deduction on that space

Example 1: A standard heated living room

{
  "type_of_room": "room",
  "surface_area": 35.5,
  "heated": true,
  "cooled": false
}

Example 2: An unheated storage attic

{
  "type_of_room": "other",
  "surface_area": 12.0,
  "heated": false,
  "cooled": false,
  "attic_without_fixed_staircase": true
}

kitchen (List)

Kitchen spaces. Points based on countertop length + features.

Field	Type	Description
type_of_room *	String	room or other
surface_area	Float	Area in m²
countertop_length *	Float	Countertop length in meters. < 1m = 0 pts, ≥ 1m = 4 pts, ≥ 2m = 7 pts
shared_addresses	Integer	Number of dwellings sharing this kitchen
open_kitchen	Boolean	Kitchen is in open connection (>50% wall) with adjacent room
heated	Boolean	Is the kitchen heated?
cooled	Boolean	Is the kitchen cooled?
kitchen_features *	Object	Kitchen feature counts. See table below.

Kitchen Features Object (Type A) All values are Integers (0 = absent, 1 = present, or specific count). Extra feature points are capped at the base countertop points.

Feature	Type
extractor_system	Integer
induction_hob	Integer
ceramic_hob	Integer
gas_hob	Integer
refrigerator	Integer
freezer	Integer
oven_electric	Integer
oven_gas	Integer
microwave	Integer
dishwasher	Integer
extra_cupboard_space_per_60cm	Integer
one_hand_mixer_tap	Integer
one_hand_mixer_tap_with_boiling_function	Integer
thermostatic_mixer_tap	Integer
thermostatic_mixer_tap_with_boiling_function	Integer

Example 1: Basic Kitchen (Short counter, gas hob)

{
  "type_of_room": "room",
  "surface_area": 8.0,
  "countertop_length": 1.8,
  "kitchen_features": {
    "gas_hob": 1,
    "extractor_system": 1,
    "dishwasher": 0,
    "refrigerator": 0
  }
}

Example 2: Luxury Kitchen (Long counter, Quooker, Induction)

{
  "type_of_room": "room",
  "surface_area": 15.0,
  "countertop_length": 3.5,
  "kitchen_features": {
    "induction_hob": 1,
    "dishwasher": 1,
    "refrigerator": 1,
    "one_hand_mixer_tap_with_boiling_function": 1,
    "extra_cupboard_space_per_60cm": 2
  }
}

sanitary (List)

Bathrooms. Updated for 2026 rules — toilet location is now specified explicitly.

Field	Type	Description
type_of_room *	String	room or other
surface_area	Float	Area in m²
shared_addresses	Integer	Number of dwellings sharing this bathroom
heated	Boolean	Is the bathroom heated?
cooled	Boolean	Is the bathroom cooled?
shower_facility *	String	Type of wash facility.
toilet_in_bathroom	Boolean	Standard toilet located inside the bathroom (+2.0 pts)
wall_hung_toilet_in_bathroom	Boolean	Wall-hung toilet inside the bathroom (+2.75 pts)
toilet_in_separate_room	Boolean	Standard toilet in a separate room within the sanitary area (+3.0 pts)
wall_hung_toilet_in_separate_room	Boolean	Wall-hung toilet in a separate room (+3.75 pts)
is_bathroom	Boolean	Whether this space is a bathroom. Affects washbasin point caps.
sanitary_features *	Object	Sanitary feature counts. See table below.

Sanitary Features Object (Type A) All values are Integers. Extra feature points are capped at the shower/bath base points.

Feature	Type
washbasin	Integer
multi_person_washbasin	Integer
cupboard_space	Boolean (0/1)
power_outlet	Integer
build_in_cupboard	Integer
complete_separation_of_shower	Integer
bath_with_bubble_function	Integer
one_hand_mixer_tap	Integer
thermostatic_mixer_tap	Integer
towel_radiator	Integer

Example 1: Standard Bathroom (Shower + Sink)

{
  "type_of_room": "other",
  "surface_area": 4.5,
  "shower_facility": "shower",
  "toilet": 0,
  "sanitary_features": {
    "washbasin": 1,
    "thermostatic_mixer_tap": 1,
    "towel_radiator": 0
  }
}

Example 2: Full Bathroom (Bath, Toilet, Double Sink)

{
  "type_of_room": "other",
  "surface_area": 9.0,
  "shower_facility": "bath",
  "toilet": 1,
  "sanitary_features": {
    "wall_hung_toilet": 1,
    "multi_person_washbasin": 1,
    "towel_radiator": 1,
    "bath_with_bubble_function": 1
  }
}

toilet (List)

Separate toilet rooms (standalone, not inside a bathroom).

Field	Type	Description
type_of_room *	String	room or other
surface_area	Float	Area in m²
shared_addresses	Integer	Number of dwellings sharing this toilet
heated	Boolean	Is the room heated?
cooled	Boolean	Is the room cooled?
wall_hung_toilet	Boolean	Wall-hung toilet (+3.75 pts) vs standard (+3.0 pts)
washbasin	Integer	Count of washbasins (+1.0 pt each)

Example 1: Standard Toilet

{
  "type_of_room": "other",
  "surface_area": 1.2,
  "wall_hung_toilet": false,
  "washbasin": 0
}

Example 2: Modern Toilet with Fountain

{
  "type_of_room": "other",
  "surface_area": 1.5,
  "wall_hung_toilet": true,
  "washbasin": 1
}

outdoor (List)

Gardens, balconies, terraces. No outdoor space = -5 pts penalty.

Field	Type	Description
surface_area	Float	Area in m²
shared_addresses	Integer	Number of dwellings sharing this outdoor space

Example 1: Small Balcony

{
  "surface_area": 6.5
}

Example 2: Large Garden

{
  "surface_area": 45.0
}

parking (List)

Shared or private parking spaces.

Field	Type	Description
parking_type	Integer	1 = Garage/Indoor (9 pts), 2 = Carport/Covered (6 pts), 3 = Open (4 pts)
surface_area	Float	Area in m²
shared_addresses	Integer	Number of dwellings sharing this parking space
charging_station	Boolean	Has EV charging point (+2 pts)

Example 1: Private Garage with Charger

{
  "parking_type": 1,
  "charging_station": true
}

Example 2: Carport

{
  "parking_type": 2,
  "charging_station": false
}

1.3 Example JSON (Type A)

{
  "house_type": "Meergezinswoning",
  "build_year": 2005,
  "woz_valuation_year": 2024,
  "woz_value": 250000,
  "energy_label": "B",
  "energy_index_existence": false,
  "energy_index": 0,
  "energy_performance_compensation": false,
  "corop_area_amsterdam_or_utrecth": false,
  "usable_surface_area": 75.0,
  "contract_start_date": "2024-01-15",
  "monument": "",
  "care_home": false,
  "doorbell": true,
  "disability_costs": 0,
  "disabled_people": 0,
  "rooms": [
    {
      "type_of_room": "room",
      "surface_area": 20.5,
      "shared_addresses": 1,
      "heated": true,
      "cooled": false,
      "attic_without_fixed_staircase": false
    },
    {
      "type_of_room": "other",
      "surface_area": 8.0,
      "shared_addresses": 1,
      "heated": false,
      "cooled": false,
      "attic_without_fixed_staircase": false
    }
  ],
  "kitchen": [
    {
      "type_of_room": "room",
      "open_kitchen": false,
      "surface_area": 12.0,
      "countertop_length": 2.5,
      "shared_addresses": 1,
      "heated": true,
      "cooled": false,
      "kitchen_features": {
        "extractor_system": 1,
        "induction_hob": 1,
        "ceramic_hob": 0,
        "gas_hob": 0,
        "refrigerator": 1,
        "freezer": 0,
        "oven_electric": 1,
        "oven_gas": 0,
        "microwave": 1,
        "dishwasher": 1,
        "extra_cupboard_space_per_60cm": 2,
        "one_hand_mixer_tap": 0,
        "one_hand_mixer_tap_with_boiling_function": 1,
        "thermostatic_mixer_tap": 0,
        "thermostatic_mixer_tap_with_boiling_function": 0
      }
    }
  ],
  "sanitary": [
    {
      "type_of_room": "other",
      "surface_area": 5.0,
      "heated": false,
      "cooled": false,
      "shower_facility": "shower",
      "toilet_in_bathroom": true,
      "wall_hung_toilet_in_bathroom": false,
      "toilet_in_separate_room": false,
      "wall_hung_toilet_in_separate_room": false,
      "is_bathroom": true,
      "shared_addresses": 1,
      "sanitary_features": {
        "washbasin": 1,
        "multi_person_washbasin": 0,
        "cupboard_space": 0,
        "power_outlet": 1,
        "build_in_cupboard": 0,
        "complete_separation_of_shower": 0,
        "bath_with_bubble_function": 0,
        "one_hand_mixer_tap": 1,
        "thermostatic_mixer_tap": 0,
        "towel_radiator": 0
      }
    }
  ],
  "toilet": [
    {
      "type_of_room": "other",
      "surface_area": 2.0,
      "heated": false,
      "cooled": false,
      "wall_hung_toilet": true,
      "washbasin": 1,
      "shared_addresses": 1
    }
  ],
  "outdoor": [
    {
      "surface_area": 20.0,
      "shared_addresses": 1
    }
  ],
  "parking": [
    {
      "parking_type": 2,
      "surface_area": 15.0,
      "shared_addresses": 1,
      "charging_station": true
    }
  ]
}