BAG Adres Lookup

MCP

Stuur een Nederlandse postcode en huisnummer en ontvang volledige BAG-adresdata: BAG-identificatoren, gebruiksdoelen, oppervlakte, bouwjaar, status en GPS-coördinaten. Data uit de PDOK BAG open API (Landelijke Voorziening BAG). Resultaten worden 24 uur gecached; bij uitval van PDOK retourneert de API HTTP 503.

30 verzoeken/min

1.00 credit / call

Geo

Usecases

Adresverificatie

Valideer of een ingevoerd adres officieel bestaat in de BAG en haal de juiste schrijfwijze op.

Vastgoeddata verrijken

Verrijk pand- en adresdata met BAG-ID's, gebruiksdoel en bouwjaar voor integratie met andere databronnen.

Adresvorm bij checkout

Haal het officiële adres op bij postcode + huisnummer voor correcte bezorg- en factuurgegevens.

Veelgestelde vragen

Waar komt de data vandaan?

Hoe worden resultaten gecached?

Wat zijn de kosten voor deze api?

Integratie voorbeeld

Integreren in jouw applicatie? Probeer onze codevoorbeelden hieronder of bekijk de volledige documentatie voor meer details en extra talen en/of collecties.

curl "https://api.getapi.nl/api/v1/kadaster/bag/address?postcode=1234AB&house_number=1&house_letter=value&house_number_addition=value" \
  --header "X-Api-Key: ga_live_YOUR_KEY"

const response = await fetch('https://api.getapi.nl/api/v1/kadaster/bag/address?postcode=1234AB&house_number=1&house_letter=value&house_number_addition=value', {
  method: 'GET',
  headers: {
    'X-Api-Key': 'ga_live_YOUR_KEY',
  },
});

const data = await response.json();

$ch = curl_init();

$headers = [
    'X-Api-Key: ga_live_YOUR_KEY',
];

curl_setopt_array($ch, [
    CURLOPT_URL            => 'https://api.getapi.nl/api/v1/kadaster/bag/address?postcode=1234AB&house_number=1&house_letter=value&house_number_addition=value',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => $headers,
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

headers = {
    'X-Api-Key': 'ga_live_YOUR_KEY',
}

params = {
    'postcode': '1234AB',
    'house_number': '1',
    'house_letter': 'value',
    'house_number_addition': 'value',
}

response = requests.get('https://api.getapi.nl/api/v1/kadaster/bag/address', headers=headers, params=params)
data = response.json()

{
    "found": true,
    "address": {
        "bag_nummeraanduiding_id": "0363200000218908",
        "bag_verblijfsobject_id": "0363010000218908",
        "bag_pand_ids": [
            "0363100012165277"
        ],
        "bag_openbare_ruimte_id": "0363300000006316",
        "bag_woonplaats_id": "3594",
        "street": "Damrak",
        "short_name": "Damrak",
        "house_number": 1,
        "house_letter": null,
        "house_number_addition": null,
        "postcode": "1012LG",
        "city": "Amsterdam",
        "address_line": "Damrak 1",
        "address_line_postal": "1012 LG  AMSTERDAM",
        "usage_purposes": [
            "retail"
        ],
        "surface_area_m2": 312,
        "build_year": 1900,
        "status": "in_use",
        "type": "residence",
        "is_secondary_address": false,
        "is_observed": false,
        "in_investigation": null,
        "document_date": "2019-11-22",
        "document_number": "19SZ2048",
        "secondary_address_ids": [],
        "occurrence": null,
        "lat": 52.3745,
        "lon": 4.8986
    }
}

Responsvelden

Overzicht van alle velden die de API teruggeeft in een succesvol antwoord.

Veld	Type	Verplicht
`found`	boolean	nee
`address`	object	nee
└ `bag_nummeraanduiding_id`	string	nee
└ `bag_verblijfsobject_id`	string	nee
└ `bag_pand_ids`	array	nee
└ `bag_openbare_ruimte_id`	string	nee
└ `bag_woonplaats_id`	string	nee
└ `street`	string	nee
└ `short_name`	string	nee
└ `house_number`	integer	nee
└ `house_letter`	null	nee
└ `house_number_addition`	null	nee
└ `postcode`	string	nee
└ `city`	string	nee
└ `address_line`	string	nee
└ `address_line_postal`	string	nee
└ `usage_purposes`	array	nee
└ `surface_area_m2`	integer	nee
└ `build_year`	integer	nee
└ `status`	string	nee
└ `type`	string	nee
└ `is_secondary_address`	boolean	nee
└ `is_observed`	boolean	nee
└ `in_investigation`	null	nee
└ `document_date`	string	nee
└ `document_number`	string	nee
└ `secondary_address_ids`	array	nee
└ `occurrence`	null	nee
└ `lat`	number	nee
└ `lon`	number	nee

Limieten & kosten

Tier	Rate limit	Kosten per call
Gratis	30 verzoeken/min	1.00 credit
Betaald	60 verzoeken/min	1.00 credit
Premium	60 verzoeken/min	1.00 credit

Credits worden afgeschreven per succesvol verzoek. Bekijk onze prijzen voor meer informatie over creditpakketten.

Documentatie & codevoorbeelden

Klaar om te integreren?

Bekijk de volledige API-referentie met authenticatie, endpoints en automatisch gegenereerde codevoorbeelden in cURL, PHP, JavaScript en Python.

Bekijk API-referentie Gratis proberen Download OpenAPI spec (.json)