BAG API Nederland: adres- en gebouwdata via 1 endpoint

De BAG (Basisregistratie Adressen en Gebouwen) is de officiele Nederlandse registratie van alle adressen en gebouwen. Met een BAG API haal je die adres- en gebouwdata programmatisch op en valideer of verrijk je adressen in je eigen applicatie. In dit artikel lees je wat de BAG is, wat je met een BAG API in Nederland kunt en hoe je BAG- en WOZ-data in een enkele call combineert.

Wat is de BAG (Basisregistratie Adressen en Gebouwen)?

De BAG is een van de basisregistraties van de Nederlandse overheid. Gemeenten leggen hierin alle adressen en gebouwen vast, met unieke identificaties per object. Denk aan verblijfsobjecten, panden, nummeraanduidingen, openbare ruimten en woonplaatsen. Omdat elk object een landelijk unieke sleutel heeft, is de BAG de betrouwbare basis om adressen in Nederland eenduidig te identificeren.

Wat kun je met een BAG API?

• Adresvalidatie: controleer of een ingevoerd adres echt bestaat;
• Adresverrijking: vul postcode, woonplaats en unieke BAG-id aan;
• Koppeling met andere data: gebruik de BAG-identificaties als sleutel om te koppelen met bronnen zoals de WOZ;
• Datakwaliteit: normaliseer en ontdubbel adressen in je database.

BAG-gegevens opvragen via de WozApi BAG API

Met WozApi haal je BAG-adresgegevens op via hetzelfde adres-endpoint dat ook de WOZ-waarde teruggeeft. Stuur je API-key mee als header en geef een adres op:

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

In de response zit het bag-object met de belangrijkste adres- en identificatievelden:

"bag": {
  "adresseerbaarobjectId": "0363010000000001",
  "nummeraanduidingId": "0363200000000001",
  "straatnaam": "Damrak",
  "huisnummer": 1,
  "postcode": "1012LG",
  "woonplaatsnaam": "Amsterdam"
}

Werk je liever met identificaties? Dan kun je ook opvragen op nummeraanduiding of adresseerbaar object via /Api/Nummeraanduiding/{id} en /Api/AdresseerbaarObject/{id}. De volledige set endpoints staat in de API-documentatie.

BAG en WOZ combineren in 1 call

Het grote voordeel van WozApi is dat je de BAG-adresgegevens en de WOZ-waarde in dezelfde response krijgt. Je hoeft dus geen twee bronnen te koppelen: 1 API-endpoint geeft zowel het gevalideerde adres als de WOZ-waarde per peildatum. Hoe je de WOZ-kant gebruikt, lees je in ons artikel over de WOZ-waarde opvragen via een API.

Welke velden krijg je terug?

• adresseerbaarobjectId en nummeraanduidingId: de unieke BAG-sleutels;
• straatnaam, huisnummer, postcode en woonplaatsnaam: het genormaliseerde adres.

BAG API versus open bronnen

De BAG is als open data beschikbaar via onder andere PDOK, maar het zelf inrichten en actueel houden van die dataset kost tijd en beheer. Een kant-en-klare BAG API bespaart je dat werk: je doet een call en krijgt direct gevalideerde adresdata terug, gecombineerd met de WOZ-waarde. Zie ook onze vergelijking van bronnen en aanbieders.

Kosten en gratis testen

Je rekent af per uniek adres met credits: 1 credit is 1 adres, en hetzelfde adres binnen 7 dagen opnieuw opvragen is gratis. De prijs per credit start bij EUR 0,35 excl. btw; bekijk de staffels op de prijzenpagina. Nieuwe accounts krijgen 10 gratis credits om de BAG API te testen.