Woningrisico API — het risicoprofiel van een adres, in één call

Hoe het begon

Een huis heeft een prijs. Het heeft ook een risicoprofiel, en die helft ligt verspreid over een stuk of tien overheidsdatasets, elk met een eigen formaat, een eigen granulariteit en een eigen licentie. Deltares weet iets over funderingen. RVO weet iets over energielabels. KNMI weet iets over aardbevingen. CBS weet wat de buurt waard is. Geen van hen weet iets van elkaar.

Wat het doet

De Woningrisico API zoekt bij een postcode en huisnummer één BAG-adres op en antwoordt met het risicoprofiel van het pand waar dat adres in zit: waterdiepte bij extreme regen, funderingsrisico (paalrot en verschilzetting), energielabel en CO2, WOZ-gemiddelden van het gebied, overstroming, bodemdaling, grondwater, hitte, natuurbrand en aardbevingen — met het dichtstbijzijnde gasveld erbij.

Gebouwd zodat je het antwoord kunt vertrouwen

Elk blok draagt zijn herkomst mee: dataset, versie, granulariteit, licentie, bronvermelding. En elk blok draagt een status, want ontbrekende data is ook een feit — OK, PARTIAL, NODATA, NO_ACTIVE_VERSION, UNAVAILABLE. Een veld is nooit zomaar afwezig. Geweigerde verzoeken antwoorden in één vorm met een vaste foutcode, en een 404 zegt welke soort: adres niet gevonden, adres dubbelzinnig (met de kandidaten erbij) of pand niet gevonden. Antwoorden dragen een ETag, zodat een integratie goedkoop opnieuw kan vragen. Elk pad is geversioneerd.

Eerlijk over wat het is

Dit zijn landelijke screeningsmodellen. De API zegt iets over een locatie, niet over de staat van één specifiek gebouw — en dat staat in de documentatie zelf, niet in de kleine lettertjes.