GET/v1/referenties

Referenties — API-endpoint

Geeft vergelijkbare woningen die recent zijn verkocht, gesorteerd op vergelijkbaarheid.

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Ja	Postcode zonder spatie.
huisnummer	integer	Ja	Huisnummer.
huisletter	string	Nee	Huisletter, indien van toepassing.
toevoeging	string	Nee	Huisnummertoevoeging, indien van toepassing.
aantal	integer	Nee	Aantal referenties (1–20). Standaard 5.
max_afstand_m	integer	Nee	Maximale afstand in meters. Standaard 1000.

Voorbeeld-request

cURL

curl "https://api.dometrum.nl/v1/referenties?postcode=3511AB&huisnummer=12&aantal=3" \
  -H "X-API-Key: UW_API_SLEUTEL"

Voorbeeld-response

200 OK · application/json

{
  "referenties": [
    {
      "adres": "Stationsstraat 8, Utrecht",
      "verkoopdatum": "2026-08-14",
      "koopsom": 405000,
      "afstand_m": 40,
      "woonoppervlakte_m2": 108,
      "vergelijkbaarheid": 0.94
    },
    {
      "adres": "Kanaalstraat 31, Utrecht",
      "verkoopdatum": "2026-06-02",
      "koopsom": 419000,
      "afstand_m": 310,
      "woonoppervlakte_m2": 115,
      "vergelijkbaarheid": 0.89
    }
  ]
}

Velden

verkoopdatum date: Datum van levering.
koopsom integer: Geregistreerde koopsom in euro's.
afstand_m integer: Hemelsbrede afstand tot de woning in meters.
vergelijkbaarheid number: Score van 0 tot 1: hoe goed de referentie op de woning lijkt.