Stuur een BAG nummeraanduiding-ID (16 cijfers) en ontvang de volledige BAG-adresdata voor dat id. Data uit de PDOK BAG open API. Resultaten worden 24 uur gecached.
De data komt rechtstreeks uit de PDOK BAG open API.
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/id?id=value" \
--header "X-Api-Key: ga_live_YOUR_KEY"
const response = await fetch('https://api.getapi.nl/api/v1/kadaster/bag/id?id=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/id?id=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 = {
'id': 'value',
}
response = requests.get('https://api.getapi.nl/api/v1/kadaster/bag/id', 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
}
}
Overzicht van alle velden die de API teruggeeft in een succesvol antwoord.
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
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 |
| 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
Bekijk de volledige API-referentie met authenticatie, endpoints en automatisch gegenereerde codevoorbeelden in cURL, PHP, JavaScript en Python.