BAG API Huidige Bevragingen

API staat voor Application Programming Interface. Met een API kan een computerprogramma communiceren met een ander programma of onderdelen ervan. Zo kunt u een database of programma bevragen. Vergelijk het met een digitale stekkerdoos die externe partijen toegang geeft tot interne gegevens. Past uw stekker niet, dan hebt u geen toegang. Wij maken voor u een API, oftewel een passende stekker, aan. 

Het programma Haal Centraal ontwikkelt API’s waarmee gemeenten basisgegevens rechtstreeks bij de landelijke registraties kunnen bevragen. Het Kadaster biedt de volgende Haal Centraal API’s waarop gemeenten kunnen aansluiten:  

• BAG API Huidige Bevragingen
• BRK Bevragen API
• WOZ API Huidige Bevragingen

Lees meer over Haal Centraal op de website van VNG.

Vooralsnog wordt de API Huidige Bevragingen uitsluitend beschikbaar gesteld voor gemeenten en leveranciers van gemeenten.

Ontwikkelt u een client applicatie en wilt u testen of de code correct is? Dan kunt u hiervoor gebruikmaken van de testomgeving. U kunt een API key voor de BAG API Huidige Bevragingen aanvragen met het formulier Aanvragen BAG API key. U ontvangt dan een API key voor zowel de testomgeving als de productieomgeving.

Met de BAG API Huidige Bevragingen is het mogelijk om kosteloos een beperkt aantal bevragingen te doen. Vooralsnog stellen wij de API Huidige Bevragingen uitsluitend voor (leveranciers van) gemeenten beschikbaar.    

Het verschil tussen de 2 API’s zit voornamelijk in de implementatie. De BAG API Huidige Bevragingen is ontwikkeld op basis van de gebruikerswensen van gemeenten, die hebben alleen behoefte aan huidige gegevens. Bij de ontwikkeling van de API zijn keuzes gemaakt die de implementatie voor gemeenten eenvoudiger maken. Daarnaast is de implementatie van de Huidige Bevragingen API in lijn met de andere Haal Centraal API’s.

Via de BAG API Individuele Bevragingen kan de hele BAG bevraagd worden, zowel actueel als historisch, inclusief alle gegeven die in de BAG bekend zijn. Bij de ontwikkeling van de BAG API Individuele Bevragingen is geen rekening gehouden met specifieke gebruikerswensen. Ga voor meer informatie naar de pagina BAG API Individuele Bevragingen.

In de BAG wordt van alle objecten de historie bewaart, de levenscyclus van de objecten bestaat uit voorkomens. Wanneer de huidige gegevens opgevraagd worden, leveren we de gegevens die op dat moment gelden: de actuele gegevens. Daarbij filteren we de gegevens van objecten die een historische status hebben (denk bijvoorbeeld aan de gegevens van een gebouw dat gesloopt is) eruit. In de Praktijkhandleiding  op Github vindt u een uitgebreide toelichting  over het verschil tussen actieve voorkomens, actuele voorkomens en huidige voorkomens.

Nee, alle genoemde bedragen zijn vrij van btw.

Voor het leveren van BAG-producten door het Kadaster gelden de algemene voorwaarden van het Kadaster. BAG-data zijn open data. Voor het gebruik van de gegevens uit de BAG geldt de Creative Commons Public Domain Mark v1.0.

Ondersteuning van de API vindt plaats op basis van ‘best effort’ op werkdagen van 07.00 uur tot 18.00 uur. In de praktijk is de BAG API Huidige Bevragingen altijd beschikbaar tenzij onderhoud plaatsvindt of er verstoringen zijn.

Hebt u een vraag waarop u het antwoord niet kon vinden? Neem dan contact op met de klantenservice BAG op telefoonnummer 088 - 183 34 00. Onze medewerkers zijn u op werkdagen van 9.00 tot 17.00 uur graag van dienst. Of stel uw vraag direct via het contactformulier.