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.

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/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/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/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/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",
        "municipality": "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	ja
`address`	object	ja
└ `bag_nummeraanduiding_id`	string	ja
└ `bag_verblijfsobject_id`	string	ja
└ `bag_pand_ids`	array	ja
└ `bag_openbare_ruimte_id`	string	ja
└ `bag_woonplaats_id`	string	ja
└ `street`	string null	ja
└ `short_name`	string null	ja
└ `house_number`	integer	ja
└ `house_letter`	string null	ja
└ `house_number_addition`	string null	ja
└ `postcode`	string	ja
└ `city`	string	ja
└ `municipality`	string	ja
└ `address_line`	string	ja
└ `address_line_postal`	string	ja
└ `usage_purposes`	array	ja
└ `surface_area_m2`	integer null	ja
└ `build_year`	integer null	ja
└ `status`	string null	ja
└ `type`	string null	ja
└ `is_secondary_address`	boolean	ja
└ `is_observed`	boolean null	ja
└ `in_investigation`	string	ja
└ `document_date`	string null	ja
└ `document_number`	string null	ja
└ `secondary_address_ids`	array	ja
└ `occurrence`	string	ja
└ `lat`	number null	ja
└ `lon`	number null	ja

Limieten & kosten

Tier	Rate limit	Kosten per call	Cached request
Trial	30 verzoeken/min	1.00 credit	0.00 credits
Betaald	120 verzoeken/min	1.00 credit	0.00 credits

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)