BAG API Huidige Bevragingen

API staat voor Application Programming Interface. Met een API kan een computerprogramma communiceren met een ander programma of onderdelen ervan. Vergelijk het met een digitale stekkerdoos die externe partijen toegang geeft tot interne gegevens.

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

Om te bepalen of deze API voor u geschikt is, is een testomgeving beschikbaar. Voor de testomgeving hebt u een specifieke API key nodig. Deze key vraag u aan met het formulier Aanvragen API key BAG API Huidige Bevragingen Testomgeving.

Met de BAG API Huidige Bevragingen is het mogelijk om kosteloos een beperkt aantal bevragingen te doen. Wanneer er grote aantallen bevragingen worden gedaan, brengen wij kosten in rekening. Om welke aantallen en kosten het gaat, is op dit moment nog niet bekend.    

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.

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.