Links

Interactive Reference API

The interactive reference API gives the appraiser full flexibility on finding the right reference objects based on multiple variables, comparables and strict functions.
Interactieve woning referentie API voor het opvragen van 30 relevante transacties t.o.v. het doelobject
post
https://api.altum.ai
/interactive-reference
Interactive Reference API
This API replaced the former Reference API per the 1st of September 2022

Housetype

Possible inputs for both the feature housetype for the target object as well as housetype_to_search for the housetypes to be included in the search: 'Vrijstaande woning', 'Vrijstaande doelgroepwoning', 'Vrijstaande recreatiewoning', '2 onder 1 kap woning', 'Geschakelde 2 onder 1 kapwoning', 'Geschakelde woning', 'Tussen/rijwoning', 'Tussen/rij doelgroepwoning', 'Hoekwoning', 'Eindwoning', 'Galerijflat', 'Portiekflat', 'Corridorflat', 'Maisonnette', 'Benedenwoning', 'Bovenwoning', 'Portiekwoning'
Expand for alle possible housetype values output
When the function housetype_to_search is provided, then in the ComparableHouseType output will display the given inputs by the user (as a list) and not 0, 1 or 2. If the algorithm is not able to find at least three reference objects, then this input is ignored and the "comparable_housetype" goes to 0 in the search.

Comparable functions

  • 0 = all possible matches
  • 1 = comparable
  • 2 = comparable + better and lesser
  • 3 = maximum filter

Comparable housetype single-family home

Matrix house-type single-family home
Vrijstaande woning
Vrijstaande doelgroepwoning
2-onder-1-kapwoning
Geschakelde 2-onder-1-kapwoning
Geschakelde woning
Tussenwoning
Hoekwoning
Eindwoning
Eengezinswoning
Vrijstaande woning
Comparable
Comparable
Better
Better
Much better
Much better
Much
Much better
Much better
2-onder-1-kapwoning
Lesser
Lesser
Comparable
Comparable
Better
Better
Better
Better
Much better
Geschakelde 2-onder-1-kapwoning
Lesser
Lesser
Comparable
Comparable
Better
Better
Better
Better
Better
Geschakelde woning
Much less
Much less
Lesser
Lesser
Comparable
Comparable
Comparable
Comparable
Better
Halfvrijstaande woning
Lesser
Lesser
Comparable
Comparable
Comparable
Better
Better
Better
Better
Tussenwoning
Much less
Much less
Much less
Lesser
Lesser
Comparable
Lesser
Comparable
Comparable
Hoekwoning
Much less
Much less
Lesser
Lesser
Lesser
Better
Comparable
Comparable
Better
Eindwoning
Much less
Much less
Lesser
Lesser
Lesser
Comparable
Comparable
Comparable
Comparable

Comparable housetype appartments

Matrix house-type apartments
Galerijflat
Portiekflat
Corridorflat
Maisonnette
Benedenwoning
Bovenwoning
Portiekwoning
Meergezinswoning
Galerijflat
Comparable
Comparable
Comparable
Lesser
Lesser
Comparable
Lesser
Comparable
Portiekflat
Comparable
Comparable
Comparable
Lesser
Lesser
Comparable
Lesser
Comparable
Corridorflat
Comparable
Comparable
Comparable
Lesser
Lesser
Comparable
Lesser
Comparable
Maisonnette
Better
Better
Better
Comparable
Comparable
Lesser
Comparable
Better
Benedenwoning
Better
Better
Better
Comparable
Comparable
Comparable
Comparable
Comparable
Bovenwoning
Comparable
Comparable
Comparable
Better
Comparable
Comparable
Comparable
Comparable
Portiekwoning
Better
Better
Better
Comparable
Comparable
Comparable
Comparable
Comparable

Comparable surface area and build year

For inner surface area the comparable function works as follows:
  • 0 = all possible matches
  • 1 = comparable between <10% and >10% surface area difference
  • 2 = comparable between <20% and >20% surface area difference
  • 3 = comparable between <30% and >30% surface area difference
For buildyear:
  • 0 = all build years
  • 1 = comparable between <10 and >10 buildyear difference
  • 2 = comparable between <20 and >20 buildyear difference
  • 3 = comparable between <30 and >30 buildyear difference
Comparable distance
For distance to target object
  • 0: search within the entirety of The Netherlands
  • 1: search within a maximum radius of 1 kilometers
  • 2: search within a maximum radius of 5 kilometers

Date limit

In order to give preference to more recent transacted properties it is possible to add the optional input "date_limit" to search from 6 up to 60 months in the database for finding reference objects.