Basisregistraties bevragen gaat per registratie anders. De BAG bevraag je met de BAG API Individuele Bevragingen of je houdt een kopie bij via BAG Extract. De BGT en de kadastrale kaart zijn open data via PDOK. Eigendomsgegevens uit de BRK zijn grotendeels voor overheden, en het Handelsregister bevraag je met de API's van de KVK op basis van een abonnement.
Die verschillen bepalen je architectuur. Hieronder lees je per registratie wat je kunt bevragen, wie wat mag gebruiken, hoe je aansluit en welke bouwkeuzes je maakt rond kopieën, caching en limieten.
Wat basisregistraties zijn en welke vier je het vaakst nodig hebt
Basisregistraties zijn gegevensverzamelingen met een wettelijke basis. Overheden met een publieke taak zijn verplicht die gegevens te gebruiken in plaats van ze zelf opnieuw uit te vragen. Er zijn 10 basisregistraties, van de Basisregistratie Personen tot de Basisregistratie Ondergrond.
In applicaties die met locaties, vastgoed of bedrijven werken, komen vier registraties steeds terug:
- BAG, de Basisregistratie Adressen en Gebouwen, met alle adressen, panden, verblijfsobjecten, standplaatsen en ligplaatsen. Gemeenten zijn bronhouder, het Kadaster beheert de landelijke voorziening.
- BRK, de Basisregistratie Kadaster, met percelen, zakelijke rechten en wie die rechten heeft.
- BGT, de Basisregistratie Grootschalige Topografie, de gedetailleerde kaart van Nederland met gebouwen, wegen, water, spoor en groen. Bronhouders zijn onder meer gemeenten, provincies, waterschappen en ProRail.
- HR, het Handelsregister van de KVK, met ondernemingen, rechtspersonen en hun vestigingen.
Volgens developer.overheid.nl wordt de BAG dagelijks meer dan 10 miljoen keer geraadpleegd.
Basisregistraties bevragen per registratie: het overzicht
Elke registratie kent drie soorten toegang: individuele bevragingen via een API, open datasets en services via PDOK, en abonnementen of leveringen voor een eigen kopie.
| Registratie | Individueel bevragen | Kopie, download of services | Wie mag het gebruiken |
|---|---|---|---|
| BAG | BAG API Individuele Bevragingen (versie 2), BAG OGC Features API | BAG Extract in XML met maand of dagmutaties, services via PDOK | Open data voor iedereen, API sleutel via aanvraagformulier |
| BRK | BRK Bevragen (versie 2.0) | BRK Levering met mutaties, kadastrale kaart als open data via PDOK | BRK Bevragen alleen voor BSN gerechtigde overheidsorganisaties, kadastrale kaart voor iedereen |
| BGT | BGT Features als OGC API via PDOK | Volledige download via PDOK in GML | Vrij voor iedereen, verplicht voor overheden |
| Handelsregister | KVK API's: Zoeken, Basisprofiel, Vestigingsprofiel, Naamgeving | Mutatieservice, Open Dataset Basis Bedrijfsgegevens | API's met abonnement, open dataset voor iedereen |
PDOK staat voor Publieke Dienstverlening Op de Kaart, het platform waarop het Kadaster geodata als open data aanbiedt via viewers, WMS, WFS, downloads en OGC API's.
BAG en BGT: adressen, gebouwen en de kaart
De BAG API Individuele Bevragingen is een REST API die JSON teruggeeft met vrijwel actuele gegevens. In versie 2 bevraag je een adres samen met de objecten die bij dat adres horen, zoals het verblijfsobject en het pand. Het Kadaster is duidelijk over het doel in de richtlijnen voor gebruik: de API is bedoeld om gegevens van één of een paar objecten op te vragen die je direct gebruikt. Bulkbevragingen horen er niet bij. Er geldt een maximum van 50.000 bevragingen per dag en 50 berichten per seconde.
Heb je de hele BAG nodig, dan kies je BAG Extract. Dat is een kopie van de landelijke voorziening voor één gemeente of heel Nederland, als XML bestanden. Er is een volledige maanddownload die op de 8e van de maand verschijnt, en er zijn abonnementen met maandmutaties of dagmutaties. Ophalen kan via Mijn Kadaster, geautomatiseerd met een API sleutel of via SOAP met een PKIoverheid certificaat.
De BGT gebruik je vooral via PDOK. De BGT Features OGC API geeft objecten terug op basis van een gebied of een identificatie, in GeoJSON, JSON, JSON FG of HTML. Per bevraging krijg je maximaal 1.000 objecten, met cursorpaginering voor de volgende reeks. De API bevat de complete BGT inclusief historie en wordt dagelijks voor 12.00 uur bijgewerkt.
BRK en het Handelsregister: eigendom en bedrijfsgegevens
Bij de BRK loopt de grens tussen open en afgeschermd door de registratie heen. De kadastrale kaart met grenzen, percelen en perceelnummers is open data onder CC BY en staat dagelijks bijgewerkt op PDOK, ook als OGC API. Eigenaren staan niet op die kaart. De kaart is ook niet bedoeld voor exacte maten: de nauwkeurigheid van grenzen loopt per kwaliteitslabel uiteen van 10 cm tot 80 cm.
Eigendomsgegevens bevraag je met BRK Bevragen. Volgens het Kadaster is die API op dit moment alleen beschikbaar voor overheidsorganisaties die BSN gerechtigd zijn. Versie 2.0 is sinds 14 september 2023 de standaard, en het Kadaster meldt dat de API de komende periode niet actief wordt doorontwikkeld. Voor grote aantallen objecten is er BRK Levering, bedoeld voor overheidsorganisaties en voor organisaties met een maatschappelijk belang en veel eigendommen. Aan het gebruik van deze gegevens zijn voorwaarden verbonden, die het Kadaster per product beschrijft.
De KVK biedt vier API's voor het Handelsregister die samenwerken. Met de Zoeken API (versie 2) vind je het KVK nummer, met Basisprofiel haal je basisgegevens en de lijst met vestigingen op, Vestigingsprofiel geeft de gegevens van één vestiging en Naamgeving levert statutaire namen en handelsnamen. De Mutatieservice meldt wat er in het Handelsregister is veranderd. Je haalt die signalen zelf op, en ze bevatten alleen metadata, dus details vraag je daarna op met de andere API's.
Voor analyses zonder bedrijfsnamen is er de Open Dataset Basis Bedrijfsgegevens. Die bevat alleen BV's en NV's, geen persoonsgegevens en van het vestigingsadres alleen de eerste twee cijfers van de postcode. De set wordt elke werkdag vernieuwd en is beschikbaar via een API en als CSV bestand, onder CC BY 4.0.
Aansluiten: API sleutels, certificaten, Digikoppeling en FSC
Drie patronen komen het meest voor.
- Alleen een API sleutel. Voor de BAG API Individuele Bevragingen vraag je een sleutel aan via een formulier van het Kadaster. De open API's van PDOK vragen geen sleutel.
- Abonnement met overeenkomst en API sleutel. Voor de KVK API's teken je een overeenkomst. Daarvoor moet je organisatie ingeschreven staan in het Handelsregister en moet de ondertekenaar tekenbevoegd zijn. Je stuurt de sleutel mee in de header van elke bevraging. Met de openbare testsleutel bouw je al voordat het contract rond is.
- Certificaat en overheidsidentiteit. Voor BRK Bevragen heb je een geldig PKIoverheid certificaat met een OIN nodig, het organisatie identificatienummer voor overheden, dat voldoet aan de eisen van Digikoppeling. Daarnaast heb je een Mijn Kadaster account en een API sleutel die je na autorisatie krijgt.
Digikoppeling is de set standaarden van Logius met logistieke afspraken voor elektronisch berichtenverkeer tussen overheidsorganisaties. Sinds 2022 kent Digikoppeling een profiel voor REST API's. Voor toegang tot API's tussen organisaties gebruikt dat profiel Federatieve Service Connectiviteit, kortweg FSC. FSC versie 2.0 is opgenomen in de Digikoppeling release van 21 april 2026. Hoe dat past in de lagen van een gemeentelijke architectuur, lees je in ons artikel over de vijf lagen van Common Ground.
Live bevragen of een eigen kopie bijhouden
De belangrijkste bouwkeuze is of je applicatie de bron live bevraagt of met een eigen kopie werkt. Live bevragen past bij een paar objecten per handeling, zoals een adrescontrole of een bedrijfsprofiel bij een aanvraag. Een eigen kopie past als je grote aantallen objecten verwerkt, zoekt op eigenschappen die de API niet ondersteunt of analyses draait. De BAG API is expliciet niet bedoeld voor bulk, dus een nachtelijke verwerking van alle adressen in een gemeente hoort op BAG Extract te draaien.
Ontwerp daarna vier dingen bewust:
- Caching. Bewaar opgehaalde gegevens met een vaste houdbaarheid en sla de identificatie van het object op, zodat je later gericht kunt verversen.
- Actualiteit. Kies per gegeven welke vertraging acceptabel is. De BAG API is vrijwel actueel, BGT via PDOK wordt dagelijks bijgewerkt, de open dataset van de KVK elke werkdag en de volledige download van BAG Extract één keer per maand. Met dagmutaties of de Mutatieservice van de KVK weet je wanneer je kopie verouderd is.
- Limieten. Bouw een teller en een wachtrij rond de grenzen van de bron. Bij de BAG API zijn dat 50.000 bevragingen per dag en 50 per seconde, bij de KVK API's maximaal 300.000 bevragingen per maand en 100 per seconde, en bij de open dataset van de KVK één bevraging per minuut per IP adres.
- Foutafhandeling. Onderscheid een object dat niet bestaat van een bron die tijdelijk niet antwoordt. Probeer bij time outs en limietfouten opnieuw met oplopende wachttijd en val waar het kan terug op je cache.
Een tussenlaag houdt dit beheersbaar. Als alle bevragingen van basisregistraties via één component lopen, zitten sleutels, certificaten, caching en limieten op één plek. Hoe zo'n laag werkt, beschrijven we in wat is middleware, en de basis van endpoints en foutafhandeling staat in ons artikel over de API koppeling.
Wij bouwen al ruim dertig jaar maatwerksoftware en koppelingen, met 30+ engineers in Nijmegen en Sarajevo en 100+ projecten, gecertificeerd voor ISO 9001 en ISO 27001. Dat werk zit onder meer in een platform voor subsidieadministratie, in MRO software voor de luchtvaart en in RFID in de supply chain. Onze aanpak staat op de pagina's over software integratie en API ontwikkeling, en op de pagina voor de overheid lees je in welke omgevingen we werken.
Veelgestelde vragen
Wat zijn basisregistraties?
Basisregistraties zijn gegevensverzamelingen met een wettelijke basis, zoals de BAG voor adressen en gebouwen, de BRK voor percelen en rechten, de BGT voor de grootschalige kaart en het Handelsregister voor ondernemingen. Er zijn er tien.
Wat is het verschil tussen de BAG API en BAG Extract?
De BAG API Individuele Bevragingen is bedoeld voor het opvragen van één of een paar objecten die je direct gebruikt, met een maximum van 50.000 bevragingen per dag. BAG Extract is een kopie van de hele BAG of van één gemeente in XML, met maand of dagmutaties. Voor bulkverwerking kies je BAG Extract.
Mag een bedrijf de BRK bevragen?
De kadastrale kaart met percelen en perceelnummers is open data en bruikbaar voor iedereen. BRK Bevragen, de API met eigendomsgegevens, is op dit moment alleen beschikbaar voor overheidsorganisaties die BSN gerechtigd zijn.
Heb je Digikoppeling of FSC nodig om basisregistraties te bevragen?
Dat hangt af van de bron. Voor de BAG API volstaat een API sleutel, de open API's van PDOK vragen niets, en de KVK API's werken met een abonnement en een API sleutel. BRK Bevragen vraagt een PKIoverheid certificaat met OIN volgens Digikoppeling.
