Live · open data · onderdeel van de modellenreeks

Koop of huur?
Per adres een kans.

Geen gok, maar een getoetste kansverdeling. Eén API-call op postcode en huisnummer geeft de indicatie, de betrouwbaarheid en alle BAG-gegevens van het adres.

0API-call per adres
BAGgegevens inbegrepen
0open data, geen black box

Model 7 in de reeks. Net als Laadtijd, de F1- en WK-predictor en Stopleeftijd: gebouwd op open data, met een methode die je kunt nalopen.

Alle modellen →
Hoe het werkt

Van adres naar kansverdeling

Bewust een indicatie, geen registratie. Je krijgt er altijd bij hoe zeker het model is, en de BAG-gegevens waarop het rust.

Je stuurt een adres

Postcode, huisnummer en eventueel een toevoeging. Meer is niet nodig.

Koppeling met de BAG

Het adres wordt gekoppeld aan de Basisregistratie Adressen en Gebouwen. De koopkans per postcode (CBS) wordt per adres verfijnd met pand, oppervlakte, bouwjaar en woningen in het pand, en waar beschikbaar met openbare gegevens over corporatiebezit.

Jij krijgt de kans

Indicatie, kansen, betrouwbaarheid én de volledige BAG-gegevens van verblijfsobject en pand. In één JSON-antwoord.

Voorbeelden

Zo ziet een antwoord eruit

Kies een voorbeeldadres. De uitkomsten en BAG-gegevens zijn fictieve demodata om de vorm van het antwoord te laten zien.

De demo werkt alleen met deze voorbeeldadressen. Echte opvragingen lopen via de API met een abonnementssleutel.

—koop
—
Kies een adres
betrouwbaarheid —
Koop —Huur —
Modelkenmerken
BAG-gegevens
// kies een voorbeeldadres
API

Eén endpoint, geen gedoe

REST over HTTPS, authenticatie met een persoonlijke API-sleutel in de header. Antwoorden in JSON, UTF-8.

Request

GEThttps://arjenhouweling.nl/huurkoop/api/v1/adres
ParameterTypeToelichting
postcodestringVerplicht. 4 cijfers + 2 letters, met of zonder spatie.
huisnummerintegerVerplicht.
toevoegingstringOptioneel. Huisletter en/of toevoeging, bijv. A, 2 of A-2.
nummeraanduidingstringAlternatief voor postcode + huisnummer: de 16-cijferige BAG-id.
HeaderWaarde
AuthorizationBearer <api-sleutel>

Statuscodes

200Indicatie gevonden.
401Ontbrekende of ongeldige API-sleutel.
404Adres onbekend of geen woonfunctie; bij een ontbrekende toevoeging met beschikbare_toevoegingen. Telt niet mee voor je tegoed.
422Ongeldige postcode, huisnummer of toevoeging.
429Te veel verzoeken per minuut; zie Retry-After.
503De dataset wordt op dat moment bijgewerkt.

Response

VeldToelichting
Indicatie
indicatie"koop" of "huur" — de meest waarschijnlijke uitkomst.
kans_koop0.00 – 1.00
kans_huur0.00 – 1.00 (samen 1.00)
betrouwbaarheidhoog, middel of laag.
kenmerkenwoningtype (eengezinswoning of meergezinspand), kans_koop_postcode, bron_postcode (cbs of model) en corporatiebewijs.
model_versieVersie van het model dat de schatting maakte.
bag · adres
nummeraanduiding_id16-cijferige BAG-identificatie van het adres.
openbare_ruimteStraatnaam.
huisletterHuisletter, of null.
huisnummertoevoegingToevoeging, of null.
woonplaats, gemeenteNamen volgens de BAG.
provincieProvincienaam.
bag · verblijfsobject
verblijfsobject_id16-cijferige BAG-identificatie.
gebruiksdoelLijst, bijv. ["woonfunctie"].
oppervlakte_m2Gebruiksoppervlakte in m².
statusBAG-status van het verblijfsobject.
bag · pand
pand_id16-cijferige BAG-identificatie.
bouwjaarOorspronkelijk bouwjaar.
statusBAG-status van het pand.
verblijfsobjecten_in_pandAantal verblijfsobjecten in het pand.
woningen_in_pandWaarvan met woonfunctie.
bag · locatie
rd_x, rd_yRijksdriehoeksstelsel (EPSG:28992).
lat, lonWGS84 (EPSG:4326).
bag_peildatumStand van de BAG waarop het antwoord rust.
Zelden
meerdere_objectenAlleen als de BAG op hetzelfde adres meerdere woningen kent: de nummeraanduidingen. Vraag ze los op met nummeraanduiding.
Abonnementen

Betaal naar gebruik

Elk abonnement geeft een eigen API-sleutel en een maandelijks tegoed aan opvragingen. Opschalen of stoppen kan per maand.

Proef
€ 0 / maand

Om te testen en te integreren.

  • 100 opvragingen per maand
  • 1 API-sleutel
  • Volledige BAG-gegevens
Start gratis
Zakelijk
Op maat

Voor hoge volumes en bulkverwerking.

  • Volume naar behoefte
  • Bulkverwerking op aanvraag
  • Afspraken over beschikbaarheid
  • Verwerkersovereenkomst
Neem contact op
Vragen

Goed om te weten

Is dit een officiële registratie?

Nee. De koop/huur-indicatie is een statistische schatting. Daarom staat bij elke uitkomst een kans en een betrouwbaarheidsklasse. Gebruik het als indicatie, niet als bewijs. De meegeleverde BAG-gegevens komen wel rechtstreeks uit de basisregistratie.

Hoe actueel zijn de BAG-gegevens?

Elk antwoord bevat een bag_peildatum: de stand van de BAG waarop het antwoord rust. Zo weet je altijd hoe vers de gegevens zijn.

Worden er persoonsgegevens verwerkt?

Nee. Het model werkt met openbare gegevens op postcode-, pand- en adresniveau en zegt niets over wie er woont. In de verbruiksadministratie leggen we per call alleen het tijdstip en de uitkomst vast, niet het opgevraagde adres.

Wat gebeurt er bij adressen zonder woonfunctie?

Dan krijg je een 404 terug en telt de opvraging niet mee voor je tegoed.

Hoe actueel is het model?

Elke uitkomst bevat de modelversie. Een nieuwe versie wordt vooraf aangekondigd, zodat je weet wanneer uitkomsten kunnen verschuiven.

Kan ik een hele lijst adressen tegelijk laten verwerken?

Ja, binnen het zakelijke abonnement is bulkverwerking mogelijk. Neem contact op voor de mogelijkheden.