Gebouwgegevens API: bouwjaar, oppervlakte en gebruiksdoel uit de BAG

Alles wat de Basisregistratie Adressen en Gebouwen over één adres weet, in één antwoord. Je krijgt het adres zoals bij de Postcode API, plus het gebouw (bouwjaar, oppervlakte, gebruiksdoel, status), de buurt- en wijkindeling van het CBS, het waterschap, de kadastrale percelen en alle BAG-identificaties.

Bron: BAG via PDOK · CC0. Bronnen en licenties

Wat kun je ermee?

  • Bouwjaar en woonoppervlakte invullen bij een offerte voor isolatie, zonnepanelen of een verzekering.
  • Adressen indelen naar buurt, wijk of waterschap voor rapportages en statistiek (koppelen aan CBS-cijfers via de buurtcode).
  • Controleren of een adres een woning, winkel of kantoor is, of een woonboot of woonwagen.

Handig bij het integreren

Je vraagt het adres op zoals bij de Postcode API, met postcode, huisnummer en eventueel ?toevoeging=. Een ligplaats (woonboot) of standplaats (woonwagen) heeft geen gebouw in de BAG: dan is gebouw null en zegt objecttype welk soort adres het is. Een verblijfsobject kan in meer panden liggen; panden is daarom een lijst. Elke opzoeking telt als één request.

Je gebruikt één X-API-Key voor alle beschikbare bronnen. Antwoorden hebben dezelfde JSON-omhulling en vaste foutcodes. Met de limietheaders en het verbruik in je dashboard houd je bij hoeveel requests je nog hebt.

Goed om te weten

De oppervlakte is de gebruiksoppervlakte volgens de BAG, geen gemeten woonoppervlakte voor bijvoorbeeld een taxatie. Het bouwjaar is het jaar van oplevering van het pand, niet van een latere renovatie. Gegevens over eigenaren of de WOZ-waarde zitten er niet in.

NLAPI bewaart bronantwoorden in een buffer. Als de bron tijdelijk niet reageert kan een eerdere versie worden geleverd, zolang die nog bruikbaar is. Dat herken je aan meta.verouderd. Beschikbaarheid en actualiteit zijn niet gegarandeerd.

Endpoints en voorbeelden

Gebouw en buurt bij een adres

GET /v1/gebouw/{postcode}/{huisnummer}

Parameters, JSON en codevoorbeelden

Voorbeelden in curl, PHP, Node.js en Python. Importeer OpenAPI JSON in Postman, Insomnia of je coding agent.

Start gratis Bekijk pakketten

Combineer met andere Nederlandse data

Postcode API: Nederlands adres opzoekenRDW API: voertuiggegevens op kentekenFeestdagen API voor NederlandSchoolvakanties API per regioKNMI weer API per plaats of postcode