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 pakkettenCombineer 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