Mag je WOZ-waarden in bulk opvragen? Juridische kaders, technische routes en kosten per adres

Mag je WOZ-waarden in bulk opvragen?

Ja, mits je dat via een toelaatbare bron en met een rechtmatige grondslag doet. De WOZ-waarde is openbaar in de zin dat iedereen een adres mag opzoeken, maar er is geen landelijk open dataset met waardes per adres om vrij te hergebruiken. De publieke voorziening, het WOZ-waardeloket, is bedoeld voor individuele raadpleging door burgers en bedrijven. Massale, geautomatiseerde opvragingen zijn in strijd met de gebruiksvoorwaarden van het loket. De Landelijke Voorziening WOZ (LV WOZ) ontsluit gegevens richting bevoegde afnemers; rechtstreeks aansluiten is voor een beperkte groep partijen met wettelijke taak of expliciete bevoegdheid.

Voor fintech, proptech en vastgoeddata-teams die bulk willen verwerken, zijn commerciële of intermediaire API’s met een duidelijke licentie en technische documentatie de praktische route. Daarbij blijf je binnen de spelregels, kun je je verwerkingen onderbouwen en krijg je stabiele interfacegaranties.

Waar haal je WOZ-data officieel vandaan als je wilt schalen?

De keten werkt in stappen:

• Gemeenten stellen jaarlijks de WOZ-waarde vast voor elk WOZ-object naar de peildatum 1 januari van het voorafgaande kalenderjaar.
• De Landelijke Voorziening WOZ (onder beheer in de landelijke keten) zorgt voor distributie naar afnemers die daar recht op hebben.
• Het openbare WOZ-waardeloket ontsluit waarden per adres voor individuele raadpleging door het publiek.

PDOK is het nationale platform voor geografische open data, maar biedt geen open dataset met actuele WOZ-waarden per adres. Kadaster publiceert wel open datasets en services, maar WOZ-waarden zelf vallen niet onder die open datasets. Er bestaan daarnaast diensten en producten voor geautoriseerde afnemers (zoals WOZ+), die niet vrij publiek zijn.

Wat staat er in de Wet WOZ over peildatum en openbaarmaking?

Voor je datamodel is één wetsfeit het belangrijkst: de waardepeildatum. Volgens artikel 18 van de Wet waardering onroerende zaken wordt de waarde vastgesteld naar de waardepeildatum van 1 januari van het aan het belastingjaar voorafgaande jaar. Concreet betekent dit dat de WOZ-waarde die geldt voor beschikkingjaar 2025 is bepaald naar peildatum 1 januari 2024. Neem beide datapunten op in je model: het beschikkingjaar (bijvoorbeeld 2025) en de bijbehorende peildatum (1 januari 2024).

De wet regelt ook de openbaarheid van de waarde. Het publiek kan per adres de WOZ-waarde raadplegen via het WOZ-waardeloket. Dat maakt de waarde raadpleegbaar, maar niet automatisch tot vrij herbruikbare open data in bulk. Voor hergebruik gelden voorwaarden en, waar relevant, privacy- en zorgvuldigheidseisen.

Wat mag je via het WOZ-waardeloket wel en niet doen?

Het loket is opgezet voor het opzoeken van waarden per individueel adres. Wat wel kan:

• Een WOZ-waarde opvragen bij een bekend adres, met weergave van peildatum en bijbehorende context.
• Historische raadpleging binnen de jaren die het loket toont.

Wat niet is toegestaan:

• Geautomatiseerde, massale opvragingen of scraping van het loket.
• Cachen en doorleveren van loketdata buiten de kaders van de gebruiksvoorwaarden.

Als je een project of applicatie hebt waarin je duizenden adressen wilt verwerken, kies dan niet voor geautomatiseerd bevragen van het loket. Werk met een API-dienst die bulk juridisch en technisch onderbouwd aanbiedt of ga na of een aansluiting via de formele keten tot de mogelijkheden behoort.

Kun je via Kadaster of PDOK vrije bulkdata over WOZ krijgen?

Kort antwoord: niet met actuele WOZ-waarden per adres. PDOK (https://www.pdok.nl) publiceert tal van open geodatasets (zoals BAG, BGT en kadastrale kaartvarianten), maar geen open dataset met adres-gebonden WOZ-waarden. Ook op de algemene open data-pagina’s van Kadaster vind je geen open bulkbestand met WOZ-waarden per adres. Er zijn wel producten en services in het WOZ-domein voor geautoriseerde afnemers, maar die vragen een wettelijke grondslag of specifieke toestemming.

Voor developers betekent dit: je combineert open basisregistraties (zoals BAG-adressen) uit PDOK met een toegestane bron voor de WOZ-waarde zelf. Zo blijft je architectuur reproduceerbaar en compliant.

Hoe modelleer je peildatum, beschikkingjaar en adreskoppeling in je database?

Een robuust schema voor WOZ-waarden bevat minimaal:

• Adresidentificatie: koppel bij voorkeur via de BAG-nummeraanduiding-id of het adresseerbaar object (verblijfsobject id). Dit voorkomt fuzzy matching op postcode-huisnummer.
• Beschikkingjaar: het kalenderjaar waarop de beschikking ziet (bijvoorbeeld 2025).
• Waardepeildatum: wettelijk 1 januari van het voorgaande jaar (bijvoorbeeld 1 januari 2024 bij beschikkingjaar 2025).
• WOZ-waarde: het bedrag behorend bij de peildatum.
• WOZ-objectreferentie: nodig om relaties naar kadastrale percelen en eventuele BAG-objecten te leggen.

Bewaar de peildatum als volwaardige datumkolom. Afgeleide labels als “T”/“T-1” zijn handig voor rapportages, maar leg de brondata exact vast. Als een adres wijzigt (bijvoorbeeld door BAG-splitsing of samenvoeging), blijft de koppeling via identificaties herleidbaar.

Hoe koppel je een adres aan een WOZ-object en kadastraal perceel via een API?

Technisch begint het bij een eenduidig adres. Met de publieke endpoints van WozApi kun je de identificaties ophalen en vervolgens de inhoudelijke gegevens bevragen:

• Adres zoeken: GET /Api/Adres (zoek een adres en haal relevante BAG-identificaties op).
• Nummeraanduiding ophalen: GET /Api/Nummeraanduiding/{id}.
• Adresseerbaar object ophalen: GET /Api/AdresseerbaarObject/{id}.
• Credits controleren: GET /Api/Credits.

Authenticatie kan via de header X-Api-Key of Authorization: ApiKey <key>. WozApi heeft bovendien één samengestelde endpoint die in één response de WOZ-waarde per peildatum, BAG-adresgegevens, het WOZ-object en kadastrale percelen met oppervlakte levert. Waar nodig vraag je perceelgrenzen als GeoJSON optioneel mee, zodat je direct kaartvisualisaties of ruimtelijke analyses kunt bouwen.

Hoe bouw je een bulkproces zonder de regels te schenden?

Hanteer deze technische en organisatorische werkwijze:

• Kies een toegestane bron: gebruik geen scraping of massaloop op het WOZ-waardeloket. Werk met een API-dienst met duidelijke voorwaarden en logging.
• Werk adresgedreven: voer een lijst met BAG-nummeraanduiding-id’s of genormaliseerde adressen door je pipeline. Dit maakt deduplicatie en hergebruik van resultaten eenvoudiger.
• Cache met herhalingslogica: bij WozApi geldt: hetzelfde adres binnen 7 dagen opnieuw opvragen kost geen extra credit. Dit is een kortingsregel; de call gaat echt naar de API. Gebruik dit om herberekeningen te beperken zonder verouderde data te serveren.
• Monitor verbruik: houd je projectkosten bij via GET /Api/Credits en log de peildata per adres.
• Leg een verwerkingsgrondslag vast: beschrijf waarom je deze gegevens verwerkt en hoe je ze beveiligt. Dat helpt bij audits en datadeelafspraken.

Wat kost een geautomatiseerde WOZ-bevraging per adres?

Bij WozApi is de prijs- en verbruiksstructuur transparant en adresgebaseerd:

• 1 credit is 1 uniek adres.
• Prijs per credit: van EUR 0,59 bij het kleinste volume tot EUR 0,30 bij de grootste bundel, exclusief btw.
• Herhaalregel: hetzelfde adres binnen 7 dagen opnieuw opvragen kost geen extra credit (kortingsregel; geen cache-bypass nodig in je eigen code).
• Starten: een nieuw account krijgt 10 gratis credits, zonder creditcard.
• Afhandeling en hosting: hosting in de EU; betalen via Mollie.

Werk je liever even zonder code, bijvoorbeeld voor validatie of pilot? Via /woz-waarden-in-excel kun je een bestand met adressen aanleveren. De proef verwerkt 5 adressen gratis; handig om je kolommen en matching te testen.

Wanneer is bulk wél verantwoord voor jouw vastgoed- of fintech-use-case?

Bulk is verdedigbaar wanneer je:

• Een legitiem doel en grondslag hebt (bijvoorbeeld portefeuillewaardering, risicoanalyse per onderpand, portefeuillemonitoring voor onderhoud of indexatie).
• De gegevens koppelt aan eigen klant- of objectlijsten, niet aan willekeurige scraping van alle straten van Nederland.
• Peildatum en beschikkingjaar expliciet meeneemt in je analyses, zodat je geen perioden door elkaar haalt.
• Privacy en beveiliging borgen en geen onnodige persoonskoppelingen maakt.

Voorbeelden: een hypotheekportefeuille in Amsterdam, Eindhoven en Zwolle verrijken met de laatst bekende WOZ-waarde per adres; of een energierenovatiepropositie prioriteren met een combinatie van BAG-kenmerken, kadastrale perceeloppervlaktes en WOZ-waarden per peildatum.

Welke valkuilen kom je tegen bij bulk-queries en hoe los je die op?

• Adresnormalisatie: verschillen in schrijfwijze (bijv. “Dr. J.P. Heijelaan” vs “Doctor J P Heijelaan”) breken matching. Los dit op door via GET /Api/Adres eerst op de officiële BAG-nummeraanduiding-id uit te komen, en vervolgvragen daarop te baseren.
• Tijdslijnen: dashboards kunnen doorschieten als je beschikkingjaar en peildatum niet uit elkaar houdt. Bewaar beide velden en toon expliciet “WOZ (peildatum 1-1-YYYY)”.
• Objectafbakening: een WOZ-object is niet altijd gelijk aan één verblijfsobject. Koppel daarom via het WOZ-object in plaats van alleen op een BAG-id als je kadastrale relaties of gezamenlijke WOZ-waardes nodig hebt.
• Geometrie-inname: GeoJSON-perceelgrenzen zijn groot. Vraag ze alleen op wanneer je ze echt nodig hebt; voor veel modellen volstaat perceeloppervlakte in m².
• Kostenbewaking: bundel je re-queries binnen 7 dagen om de creditkorting te benutten en zet GET /Api/Credits in je monitoring.

Welke vragen heb je nog over bulk WOZ-data?

• Is een WOZ-waarde een persoonsgegeven en mag ik die opslaan?
  Een WOZ-waarde kan een persoonsgegeven zijn als die aan natuurlijke personen te koppelen is. Werk met een duidelijke grondslag, doelbinding en bewaartermijn. Publiceer geen adreslijsten met WOZ-waarden zonder noodzaak en rechtmatige basis.
• Mag ik automatisch alle adressen van een stad door het WOZ-waardeloket halen?
  Nee. Het loket is voor individuele raadpleging; geautomatiseerde massaverzoeken zijn in strijd met de gebruiksvoorwaarden van het loket.
• Bestaat er een open bulkbestand met WOZ-waarden via PDOK?
  Nee. PDOK heeft veel open geodata, maar geen landelijke open dataset met actuele WOZ-waarden per adres.
• Hoe verifieer ik dat ik de juiste peildatum gebruik?
  Koppel de waarde altijd aan het beschikkingjaar en controleer dat de peildatum 1 januari van het voorafgaande jaar is (bijv. 1 januari 2024 bij beschikkingjaar 2025). Leg beide in je database vast.
• Welke authenticatie verwacht een developer-first WOZ-API?
  Bij WozApi gebruik je een API-sleutel via X-Api-Key of Authorization: ApiKey <key>. Zo kunnen je CI/CD en serverprocessen veilig en consistent bevragen.
• Hoe begin ik zonder code om te testen of de data past bij mijn model?
  Gebruik /woz-waarden-in-excel met 5 gratis proefadressen. Daarna kun je dezelfde adressen via de API bevragen, waarbij 1 credit = 1 uniek adres.

Wat is je beste volgende stap als je bulk WOZ-data wilt integreren?

Begin met je adressen en identiteiten op orde brengen (BAG-nummeraanduiding-id’s), leg je datamodel vast met zowel peildatum als beschikkingjaar, en kies een route die contractueel en technisch klopt. Gebruik geen loketscraping en ga niet zoeken naar workarounds; je wint er niets mee en riskeert inconsistentie of blokkades. Met een API die WOZ-waarde per peildatum, WOZ-object en kadastrale percelen in één response levert, kun je snel en herhaalbaar dashboards, scoring-modellen en operationele processen voeden. Test kleinschalig met de gratis credits, bekijk je throughput en kosten, en schaaf je pipeline bij tot die robuust en compliant draait.

Waarom helpt een gespecialiseerde WOZ-API jouw data-team vooruit?

Data-teams hebben behoefte aan voorspelbare interfacecontracten, duidelijke licenties en consistente JSON. Een developer-first dienst met publieke endpoints als GET /Api/Adres, GET /Api/Nummeraanduiding/{id} en GET /Api/AdresseerbaarObject/{id} versnelt matching en foutafhandeling. De combinatie van waarde per peildatum, WOZ-objectkoppeling en kadastrale percelen (oppervlaktes, en desgewenst GeoJSON) bespaart integratiewerk. Tel daarbij op: 1 credit = 1 uniek adres, prijs per credit tussen EUR 0,59 en EUR 0,30 ex btw, een 7-dagen herhaalregel zonder extra credit, 10 gratis credits bij start en EU-hosting met betalingen via Mollie. Dat maakt plannen, budgetteren en schalen concreet.

Wat is de bottom line voor bulk WOZ-waarden in vastgoed en fintech?

Bulk kan, maar niet door het openbare loket te automatiseren. Neem de Wet WOZ serieus, modelleer peildatum en beschikkingjaar expliciet en koppel via formele identificaties. Gebruik een toegestane API-bron om tienduizenden adressen betrouwbaar te verrijken, houd je kosten in de hand met een adresgebaseerde creditstructuur en borg privacy met een heldere verwerkingsgrondslag. Zo kun je schaalbare producten en analyses bouwen zonder concessies aan juridische of technische kwaliteit.

Welke bronnen gebruik je om de regels en routes te checken?

• https://woz-api.nl
• https://woz-api.nl/woz-waarden-in-excel
• https://www.wozwaardeloket.nl
• https://wetten.overheid.nl/BWBR0007119 (Wet waardering onroerende zaken)
• https://www.pdok.nl
• https://www.kadaster.nl

Geen juridisch advies; check altijd voorwaarden/licenties.