Aan de hand van een adres geeft dit endpoint tot 50 kwalitatief goede referentieobjecten terug. Deze referenties zijn voorzien van een geïndexeerde transactieprijs zodat u makkelijk de objecten in de lijst met elkaar kan vergelijken zonder rekening te houden met de verkoopdatum. Daarnaast is elke referentie voorzien van een referentiescore zodat u makkelijk kunt zien welke objecten de beste referentie zijn voor het te evalueren object. Deze score is gebaseerd op de karakteristieken van de woning, de verkoopdatum en de afstand tussen de objecten.
Voor wie is het?
U wilt een zo compleet mogelijke lijst van referentieobjecten voor een bepaald object
U wilt deze objecten graag in één oogopslag kunnen vergelijken
Wat moet ik weten?
Dit endpoint levert geen koopsommen terug. In plaats daarvan krijgt u toegang tot een geïndexeerde transactieprijs wat u in staat stelt om te vergelijken zonder rekening te houden met de verkoopdatum
Deze oplossing wordt gebruikt en regelmatig getest door onafhankelijke taxateurs
get
This endpoint returns a list of up to 50 references including indexed transaction prices. Use this endpoint if you want the most exhaustive list of references and want to compare them to an object as is.
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
postalCodestringRequired
Zipcode
Example: 1251NJ
houseNumberintegerRequired
House number
Example: 22
houseLetterstringOptional
House letter
houseNumberExtstringOptional
House number extension
valuationDatestring · dateOptional
Valuation date
Default: 2026-02-24Example: 2026-02-24
buildYearintegerOptional
Indication of the year in which the building will originally be delivered in, or is architectually ready. Also known as construction year.
Example: 1955
houseTypestring · enumOptional
Type of dwelling.
Example: 2-onder-1-kapwoningPossible values:
useSurfaceintegerOptional
The usable surface area of a property object in m2.
Example: 104
parcelSurfaceintegerOptional
The lot/parcel surface in m2.
Example: 338
locationWeightnumberOptional
Measure of Location importance in finding reference objects.
Default: 0.4Example: 0.4
houseDetailsWeightnumberOptional
Measure of House details importance in finding WOZ reference objects.
Default: 0.4Example: 0.4
volumeintegerOptional
Volume in m3.
Example: 411
energyLabelstring · enumOptional
A label indicating how well the property object is insulated.
Example: EPossible values:
nReferencesintegerOptional
Amount of reference objects to return.
Default: 50Example: 50
minUseSurfaceintegerOptional
Minimal use surface of reference objects.
Example: 100
maxUseSurfaceintegerOptional
Maximal use surface of reference objects.
Example: 200
minBuildYearintegerOptional
Minimum build year of reference objects.
Example: 2020
maxBuildYearintegerOptional
Maximum build year of reference objects.
Example: 2026
minParcelSurfaceintegerOptional
Minimal parcel surface of reference objects.
Example: 100
maxParcelSurfaceintegerOptional
Maximum parcel surface of reference objects.
Example: 400
maxDistanceintegerOptional
Maximum distance from the valuation object to the reference object in meters.
Default: 10000
minTransportDatestring · dateOptional
Minimal transport date of reference objects.
maxTransportDatestring · dateOptional
Maximum transport date of reference objects.
transportDateWeightnumberOptional
Measure of transport date importance in finding reference objects.
