WOZ-waarde opvragen via een API: zo werkt het

Wil je programmatisch de WOZ-waarde van een Nederlands adres ophalen? Met een WOZ API haal je de WOZ-waarde en BAG-adresgegevens in een enkele JSON-response op, zonder handmatig het WOZ-waardeloket te raadplegen. In dit artikel lees je precies hoe je de WOZ-waarde opvraagt via een API, wat je terugkrijgt en wat het kost.

Wat is een WOZ API en wanneer gebruik je die?

Een WOZ API is een webservice waarmee je de WOZ-waarde van een adres opvraagt vanuit je eigen applicatie. In plaats van adres voor adres het WOZ-waardeloket te doorzoeken, stuur je een HTTP-verzoek en krijg je gestructureerde data terug die je direct verwerkt in je software.

Dat is handig voor onder andere:

• Proptech- en makelaarssoftware die woningwaardes toont;
• Hypotheek- en fintech-flows die een indicatie van de woningwaarde nodig hebben;
• Belastingadvies en bezwaarsoftware rond de WOZ-beschikking;
• Datateams die vastgoedportefeuilles verrijken met de WOZ-waarde.

WOZ-waarde opvragen via een API in 3 stappen

1. Maak een gratis account. Je start met 10 gratis credits, zodat je direct kunt testen.
2. Genereer een API-key. Deze stuur je mee als X-Api-Key-header bij elk verzoek.
3. Doe je eerste call. Roep het adres-endpoint aan met het adres dat je wilt opzoeken.

De volledige parameters en responses vind je in de WOZ API-documentatie. Een uitgebreide integratiehandleiding staat in ons artikel over de WOZ API-koppeling.

Voorbeeld: WOZ-waarde opvragen met een API-call

Een WOZ-waarde opvragen doe je met een simpele GET-request naar het adres-endpoint:

curl "https://woz-api.nl/Api/Adres?adres=Damrak 1, 1012LG Amsterdam" \
  -H "X-Api-Key: JOUW_API_KEY"

De response bevat het genormaliseerde adres, de BAG-gegevens en een reeks WOZ-waarden per peildatum:

{
  "adres": "Damrak 1, 1012LG Amsterdam",
  "bag": {
    "adresseerbaarobjectId": "0363010000000001",
    "nummeraanduidingId": "0363200000000001",
    "straatnaam": "Damrak",
    "huisnummer": 1,
    "postcode": "1012LG",
    "woonplaatsnaam": "Amsterdam"
  },
  "woz": [
    { "peildatum": "2024-01-01", "vastgesteldeWaarde": 512000 },
    { "peildatum": "2023-01-01", "vastgesteldeWaarde": 478000 }
  ]
}

Wat krijg je terug?

In een enkele response combineer je twee databronnen:

• WOZ-waarde per peildatum (peildatum en vastgesteldeWaarde), vaak meerdere jaren zodat je een reeks kunt tonen;
• BAG-gegevens zoals straatnaam, huisnummer, postcode, woonplaats en de unieke BAG-identificaties.

Meer over de adres- en gebouwdata lees je in ons artikel over de BAG API voor Nederland.

Wat kost het om de WOZ-waarde op te vragen?

Je betaalt per opgevraagd adres met credits. 1 credit staat gelijk aan 1 uniek adres. Vraag je hetzelfde adres binnen 7 dagen opnieuw op, dan kost dat geen extra credit. De prijs per credit begint bij EUR 0,35 excl. btw en daalt naarmate je meer afneemt. Bekijk de actuele staffels op de prijzenpagina.

Nieuwe accounts krijgen 10 gratis credits, zodat je de WOZ API eerst kunt uitproberen voordat je iets aanschaft.

Woningen, niet-woningen en actualiteit

De WOZ-waarde van woningen is openbaar per object. Houd er rekening mee dat nieuwe WOZ-waarden gefaseerd verschijnen in de eerste maanden van het jaar en dat de peildatum altijd 1 januari van het voorgaande jaar is. Toon daarom in je applicatie zowel de peildatum als de waarde, zodat gebruikers weten welk jaar ze zien.

Zelf de WOZ-waarde opvragen via de API

Wil je direct aan de slag? Maak een gratis account aan, genereer een API-key en doe je eerste call. Vergelijk desgewenst eerst de opties op onze vergelijkingspagina.