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

get

Returns comparable properties with price ranges.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

postalCodestringRequired

Postal code

Example: 1251NJ

houseNumberintegerRequired

House number

Example: 22

houseLetterstringOptional

House letter

houseNumberExtstringOptional

House number extension

valuationDatestring · dateOptional

Valuation date

Default: 2026-07-09Example: 2026-07-09

buildYearintegerOptional

Indication of the year in which the building will originally be delivered in, or is architecturally 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: 3Example: 3

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.

Default: 0.2Example: 0.2

minReferenceScorenumberOptional

Minimal reference score of reference objects.

Default: 0.6Example: 0.6

Responses

200

MxReferenceFinderResponse

application/json

idstring · nullableOptionalExample: string

statusstringRequiredExample: success

400

HTTP 400

application/json

401

HTTP 401

application/json

403

HTTP 403

application/json

404

HTTP 404

application/json

500

HTTP 500

application/json

get/mx-reference-finder

HTTPcURLJavaScriptPython

GET /v1/mx-reference-finder?postalCode=1251NJ&houseNumber=22 HTTP/1.1
Host: api.matrixian.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "string",
  "params": {
    "postalCode": "1251NJ",
    "houseNumber": 22,
    "houseLetter": null,
    "houseNumberExt": null,
    "valuationDate": "2026-07-09",
    "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": 3,
    "minUseSurface": 100,
    "maxUseSurface": 200,
    "minBuildYear": 2020,
    "maxBuildYear": 2026,
    "minParcelSurface": 100,
    "maxParcelSurface": 400,
    "maxDistance": 10000,
    "minTransportDate": "2026-07-09",
    "maxTransportDate": "2026-07-09",
    "transportDateWeight": 0.2,
    "includeImageUrls": true,
    "minReferenceScore": 0.6,
    "customSorting": "DEFAULT"
  },
  "data": {
    "postalCode": "1251NJ",
    "houseNumber": 22,
    "houseLetter": null,
    "houseNumberExt": null,
    "houseType": "2-onder-1-kapwoning",
    "buildYear": 1955,
    "useSurface": 104,
    "useSurfaceBAG": 104,
    "parcelSurface": 338,
    "nReferences": 3,
    "references": [
      {
        "index": 1,
        "bagId": 417200000001419,
        "streetName": "Graafland",
        "postalCode": "1251NJ",
        "houseNumber": 22,
        "houseLetter": null,
        "houseNumberExt": null,
        "town": "Laren",
        "municipality": "Laren (NH.)",
        "province": "Noord-Holland",
        "latitude": 52.25291881,
        "longitude": 5.23903348,
        "distance": 200,
        "houseType": "2-onder-1-kapwoning",
        "buildYear": 1955,
        "useSurface": 104,
        "useSurfaceBAG": 104,
        "parcelSurface": 338,
        "volume": 411,
        "energyLabel": "E",
        "energyLabelIsRegistered": true,
        "energyLabelRegistrationValidUntil": "2032-04-26",
        "dateTransaction": "2026-07-09",
        "priceClassLow": 1050000,
        "priceClassHigh": 1080000,
        "dateOnOfferSince": "2026-07-09",
        "offeredPrice": 1000000,
        "status": "online",
        "storageSpace": "text",
        "exteriorSpace": "text",
        "garage": "text",
        "insulation": "text",
        "imageFront": "text",
        "description": "text",
        "addressSrc": "BAG",
        "houseTypeSrc": "BAG",
        "buildYearSrc": "BAG",
        "useSurfaceSrc": "BAG",
        "parcelSurfaceSrc": "BAG",
        "volumeSrc": "BAG",
        "energyLabelSrc": "EP Online",
        "dateTransactionSrc": "Kadaster",
        "dateOnOfferSinceSrc": "Kadaster",
        "offeredPriceSrc": "Funda",
        "statusSrc": "Funda",
        "storageSpaceSrc": "Funda",
        "exteriorSpaceSrc": "Funda",
        "garageSrc": "Funda",
        "insulationSrc": "Funda",
        "imageFrontSrc": "Funda",
        "descriptionSrc": "Funda",
        "multipleObjects": true,
        "compScore": 99.84,
        "fillGrade": 86.66,
        "ownershipSituationFunda": "text",
        "ownershipSituationKadaster": "text",
        "dateTransport": "2026-07-09",
        "dateSale": "2026-07-09",
        "transactionPriceIndexed": 1,
        "transactionPriceIndexedDateTransport": 1,
        "transactionPriceIndexedDateSale": 1,
        "isMonument": false,
        "nettUseSurface": 104,
        "referenceScore": 1,
        "dateScore": 1,
        "locationScore": 1,
        "houseDetailsScore": 1
      }
    ],
    "valuationDate": "2026-07-09",
    "frontImageUrl": "text",
    "energyLabel": "E",
    "energyLabelRegistrationValidUntil": "2032-04-26",
    "volume": 411,
    "storageSpace": "text",
    "garage": "text",
    "description": "text",
    "dateTransaction": "2026-07-09",
    "transactionPriceIndexed": 1,
    "transactionPriceIndexedDateTransport": 1,
    "transactionPriceIndexedDateSale": 1,
    "dateSale": "2026-07-09",
    "dateTransport": "2026-07-09"
  },
  "error": {},
  "meta": {},
  "status": "success"
}

get

Returns a list of reference objects and their transaction prices.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

postalCodestringRequired

Postal code

Example: 1251NJ

houseNumberintegerRequired

House number

Example: 22

houseLetterstringOptional

House letter

houseNumberExtstringOptional

House number extension

valuationDatestring · dateOptional

Valuation date

Default: 2026-07-09Example: 2026-07-09

dateTransportstring · dateOptional

The acceptance date is the date on which you, as a buyer, become the owner of the house.

Responses

200

TransactionFinderResponse

application/json

idstring · nullableOptionalExample: string

statusstringRequiredExample: success

400

HTTP 400

application/json

401

HTTP 401

application/json

403

HTTP 403

application/json

404

HTTP 404

application/json

500

HTTP 500

application/json

get/mx-transaction-finder

HTTPcURLJavaScriptPython

GET /v1/mx-transaction-finder?postalCode=1251NJ&houseNumber=22 HTTP/1.1
Host: api.matrixian.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "string",
  "params": {
    "postalCode": "1251NJ",
    "houseNumber": 22,
    "houseLetter": null,
    "houseNumberExt": null,
    "valuationDate": "2026-07-09",
    "dateTransport": "2026-07-09"
  },
  "data": {
    "postalCode": "1251NJ",
    "houseNumber": 22,
    "houseLetter": null,
    "houseNumberExt": null,
    "saleDate": "2026-07-09",
    "transportDate": "2026-07-09",
    "transactionDate": "2026-07-09",
    "transactionPrice": 1,
    "transactionPriceIndexed": 1,
    "transactionPriceIndexedDateTransport": 1,
    "transactionPriceIndexedDateSale": 1,
    "valuationDate": "2026-07-09"
  },
  "error": {},
  "meta": {},
  "status": "success"
}