Referentiewoningen API
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
Returns comparable properties with price ranges.
Zipcode
1251NJHouse number
22House letter
House number extention
Valuation date
2025-11-10Example: 2025-11-10Indication of the year in which the building will originally be delivered in, or is architectually ready. Also known as construction year.
1955Type of dwelling.
2-onder-1-kapwoningPossible values: The usable surface area of a property object in m2.
104The lot/parcel surface in m2.
338Measure of Location importance in finding reference objects.
0.4Example: 0.4Measure of House details importance in finding WOZ reference objects.
0.4Example: 0.4Volume in m3.
411A label indicating how well the property object is insulated.
EPossible values: Amount of reference objects to return.
50Example: 50Minimal use surface of reference objects.
100Maximal use surface of reference objects.
200Minimum build year of reference objects.
2020Maximum build year of reference objects.
2025Minimal parcel surface of reference objects.
100Maximum parcel surface of reference objects.
400Maximum distance from the valuation object to the reference object in meters.
10000Minimal transport date of reference objects.
Maximum transport date of reference objects.
Measure of transport date importance in finding reference objects.
0.2Example: 0.2MxReferenceFinderResponse
HTTP 400
HTTP 401
HTTP 403
HTTP 404
HTTP 500
GET /v1/mx-reference-finder?postalCode=1251NJ&houseNumber=22 HTTP/1.1
Host: api.matrixian.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"statusCode": 200,
"headers": {
"Content-Type": "application/json"
},
"isBase64Encoded": false,
"body": {
"id": "string",
"params": {
"postalCode": "1251NJ",
"houseNumber": "22",
"valuationDate": "2025-11-10",
"buildYear": "1955",
"houseType": "2-onder-1-kapwoning",
"useSurface": "104",
"parcelSurface": "338",
"allowedHouseTypes": "Appartement,2-onder-1-kapwoning",
"locationWeight": "0.4",
"houseDetailsWeight": "0.4",
"volume": "411",
"energyLabel": "E",
"nReferences": "50",
"minUseSurface": "100",
"maxUseSurface": "200",
"minBuildYear": "2020",
"maxBuildYear": "2025",
"minParcelSurface": "100",
"maxParcelSurface": "400",
"maxDistance": "10000",
"transportDateWeight": "0.2"
},
"data": {
"postal_code": "1251NJ",
"house_number": 22,
"house_letter": null,
"house_number_ext": null,
"house_type": "2-onder-1-kapwoning",
"build_year": 1955,
"use_surface": 104,
"use_surface_bag": 104,
"parcel_surface": 338,
"references": [
{
"index_nr": 1,
"number_id": 417200000001419,
"street_name": "Graafland",
"postal_code": "1251NJ",
"house_number": 22,
"house_letter": null,
"house_number_ext": null,
"city_name": "Laren",
"municipality_name": "Laren (NH.)",
"province_name": "Noord-Holland",
"latitude": 52.25291881,
"longitude": 5.23903348,
"distance": 200,
"house_type": "2-onder-1-kapwoning",
"build_year": 1955,
"use_surface": 104,
"use_surface_bag": 104,
"parcel_surface": 338,
"volume": 411,
"energy_label": "E",
"energy_label_is_registered": true,
"energy_label_registration_valid_until": "2025-11-10",
"date_transaction": "2025-11-10",
"price_class_low": 1050000,
"price_class_high": 1080000,
"date_on_offer_since": "2025-11-10",
"offered_price": 1000000,
"status": "online",
"storage_space": "text",
"exterior_space": "text",
"garage": "text",
"insulation": "text",
"image_front": "text",
"image_other": [
"text"
],
"description": "text",
"address_source": "BAG",
"house_type_source": "BAG",
"build_year_source": "BAG",
"use_surface_source": "BAG",
"parcel_surface_source": "BAG",
"volume_source": "BAG",
"energy_label_source": "EP Online",
"date_transaction_source": "Kadaster",
"date_on_offer_since_source": "Kadaster",
"offered_price_source": "Funda",
"status_source": "Funda",
"storage_space_source": "Funda",
"exterior_space_source": "Funda",
"garage_source": "Funda",
"insulation_source": "Funda",
"image_front_source": "Funda",
"image_other_source": "Funda",
"description_source": "Funda",
"multiple_objects": true,
"referenceTransactionApiCallPrice": 1,
"transaction_price": 100000,
"similarity_score": 99.84,
"filling_grade": 86.66,
"ownership_situation_funda": "text",
"ownership_situation_kadaster": "text",
"date_transport": "2025-11-10",
"date_sale": "2025-11-10",
"transaction_price_indexed": 1,
"transactions_price_indexed_date_transport": 1,
"transaction_price_indexed_date_sale": 1,
"is_monument": false,
"nett_use_surface": 104,
"reference_score": 1,
"date_score": 1,
"location_score": 1,
"house_details_score": 1
}
],
"valuation_date": "2025-11-10",
"front_image_url": "text",
"energy_label": "E",
"energy_label_registration_valid_until": "2025-11-10",
"volume": 411,
"storage_space": "text",
"garage": "text",
"description": "text",
"date_transaction": "2025-11-10",
"transaction_price_indexed": 1,
"transactions_price_indexed_date_transport": 1,
"transaction_price_indexed_date_sale": 1,
"date_sale": "2025-11-10",
"date_transport": "2025-11-10"
},
"error": {},
"meta": {},
"status": "success"
}
}Last updated