Handleiding

De WOZ API in gewone taal

Je stuurt een adres, je krijgt de WOZ-waarden terug. Deze pagina legt uit hoe dat werkt, wat er in het antwoord staat en wat het kost. Ook als je zelf niet programmeert.

Gratis account met 10 credits Technische referentie (OpenAPI)

Wat doet deze API?

De API zoekt bij een Nederlands adres de bijbehorende WOZ-waarde op, zoals de gemeente die heeft vastgesteld. Je krijgt niet alleen het bedrag, maar ook de vaste sleutels uit de Basisregistratie Adressen en Gebouwen en het perceel uit het Kadaster.

Een gemeente stelt de WOZ-waarde vast per 1 januari van een jaar. Dat moment heet de peildatum. Omdat er meerdere jaren bekend kunnen zijn, krijg je een reeks terug en niet één getal.

In drie stappen aan de slag

Maak een account. Je krijgt 10 gratis credits en je API-sleutel staat meteen klaar op je dashboard. Je hoeft niets aan te maken.
Probeer het zonder code. Op je dashboard staat een tester: adres invullen, antwoord bekijken in gewone taal. Zo weet je zeker dat je het juiste opvraagt.
Zet het in je software. Kopieer hieronder het voorbeeld in jouw taal. Werk je niet zelf in code? Stuur dit blok door naar je developer.

Je sleutel meesturen

Elke aanvraag stuurt je sleutel mee in de header X-Api-Key. Zonder sleutel mag je vijf adressen per IP-adres uitproberen, daarna is een account nodig.

Een adres opvragen

Het adres geef je als één tekst mee, bijvoorbeeld Spuistraat 36C, 1012 TT Amsterdam. Postcode en plaats mogen ontbreken zolang het adres uniek genoeg is.

curl "https://woz-api.nl/Api/Adres?adres=Spuistraat%2036C%2C%201012%20TT%20Amsterdam" \
  -H "X-Api-Key: JOUW_API_SLEUTEL"

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "JOUW_API_SLEUTEL");

var adres = Uri.EscapeDataString("Spuistraat 36C, 1012 TT Amsterdam");
var json = await http.GetStringAsync($"https://woz-api.nl/Api/Adres?adres={adres}");

// woz staat oplopend: woz[0] is de oudste peildatum. huidigeWaarde is de nieuwste.
using var doc = System.Text.Json.JsonDocument.Parse(json);
var huidig = doc.RootElement.GetProperty("huidigeWaarde");
Console.WriteLine(huidig.GetProperty("vastgesteldeWaarde").GetInt32());

const adres = encodeURIComponent("Spuistraat 36C, 1012 TT Amsterdam");

const res = await fetch(`https://woz-api.nl/Api/Adres?adres=${adres}`, {
  headers: { "X-Api-Key": "JOUW_API_SLEUTEL" }
});

if (!res.ok) throw new Error(`WozApi gaf status ${res.status}`);
const data = await res.json();

// woz staat oplopend: woz[0] is de oudste peildatum. huidigeWaarde is de nieuwste.
console.log(data.huidigeWaarde.vastgesteldeWaarde, data.huidigeWaarde.peildatum);

import requests

res = requests.get(
    "https://woz-api.nl/Api/Adres",
    params={"adres": "Spuistraat 36C, 1012 TT Amsterdam"},
    headers={"X-Api-Key": "JOUW_API_SLEUTEL"},
    timeout=30,
)
res.raise_for_status()

# woz staat oplopend: woz[0] is de oudste peildatum. huidigeWaarde is de nieuwste.
huidig = res.json()["huidigeWaarde"]
print(huidig["vastgesteldeWaarde"], huidig["peildatum"])

Wat krijg je terug?

Het antwoord bevat deze onderdelen:

adres: Het gevonden adres Zoals het in de Basisregistratie Adressen en Gebouwen staat. Handig om te controleren of je het juiste pand te pakken hebt.
huidigeWaarde: De meest recente WOZ-waarde Dit is wat je in de meeste gevallen nodig hebt: de nieuwste vastgestelde waarde met de bijbehorende peildatum. Is er geen enkele waarde bekend, dan staat hier null.
woz: Alle WOZ-waarden per peildatum Een lijst met per jaar de vastgestelde waarde in hele euro's; de peildatum is steeds 1 januari. Let op de volgorde: de lijst loopt van oud naar nieuw, dus het eerste element is de oudste waarde en het laatste de nieuwste. Wil je alleen de actuele waarde, gebruik dan huidigeWaarde.
wozObject: Het WOZ-object zelf Met het objectnummer uit de landelijke WOZ-registratie en, als het bekend is, de grondoppervlakte in vierkante meters.
bag: Vaste sleutels van het adres De nummeraanduiding en het verblijfsobject. Bewaar deze in je eigen database: ze veranderen niet als een straatnaam of schrijfwijze wijzigt.
percelen: Het kadastrale perceel Aanduiding en oppervlakte volgens de open Kadastrale Kaart, bijvoorbeeld ASD04 F 1145.

Wat het kost

Eén geslaagde opvraag van een nieuw adres kost 1 credit.
Hetzelfde adres nog eens opvragen is 7 dagen lang gratis.
Een nieuw account start met 10 gratis credits.
Je resterende saldo staat in elke respons in de header X-Credits-Remaining.

Als er iets misgaat

Bij een fout krijg je een JSON-antwoord met de velden fout, code, status en traceId.

Status	Wat het betekent	Wat je doet
`401`	De sleutel ontbreekt of klopt niet.	Controleer de header `X-Api-Key`.
`402`	Je credits zijn op.	Waardeer op via je account.
`403`	De gratis proef van vijf adressen per IP is verbruikt.	Maak een account aan en stuur je sleutel mee.
`404`	Dit adres is niet gevonden.	Controleer de schrijfwijze, of vul postcode en plaats aan.
`503`	De bron is tijdelijk niet bereikbaar. Dit ligt aan ons, niet aan je verzoek.	Probeer het opnieuw met een oplopende wachttijd, bijvoorbeeld na 1, 5 en 15 seconden. Deze fout kost geen credit.

Klaar om te beginnen?

Je sleutel staat direct klaar en je eerste tien opvragen zijn gratis.

Account aanmaken