Stuur een gedeeltelijke adres-zoekopdracht en ontvang maximaal 10 BAG-adressuggesties inclusief volledige adresgegevens en BAG-identificatoren. Ideaal voor autocomplete-functies in formulieren. Resultaten worden 1 uur gecached.
Toon automatisch adressuggesties terwijl de gebruiker een straat of postcode intikt.
Versnel registratie- en checkout-formulieren met officiële BAG-adressen.
De API retourneert maximaal 10 suggesties met volledige adresgegevens en BAG-identificatoren.
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-suggest?q=example&limit=1" \
--header "X-Api-Key: ga_live_YOUR_KEY"
const response = await fetch('https://api.getapi.nl/api/v1/kadaster/bag/address-suggest?q=example&limit=1', {
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-suggest?q=example&limit=1',
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 = {
'q': 'example',
'limit': '1',
}
response = requests.get('https://api.getapi.nl/api/v1/kadaster/bag/address-suggest', headers=headers, params=params)
data = response.json()
{
"suggestions": [
{
"id": "adr-1234567890123456",
"label": "Damrak 1, 1012LG Amsterdam",
"type": "adres",
"nummeraanduiding_id": "1234567890123456",
"verblijfsobject_id": "1234567890123456",
"postcode": "1012LG",
"house_number": 1
},
{
"id": "adr-1234567890123457",
"label": "Damrak 2, 1012LG Amsterdam",
"type": "adres",
"nummeraanduiding_id": "1234567890123457",
"verblijfsobject_id": "1234567890123457",
"postcode": "1012LG",
"house_number": 2
}
]
}
Overzicht van alle velden die de API teruggeeft in een succesvol antwoord.
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
suggestions
|
array | ja | |
└ id
|
string | ja | |
└ label
|
string | ja | |
└ type
|
string | ja | |
└ nummeraanduiding_id
|
string null | ja | |
└ verblijfsobject_id
|
string null | ja | |
└ postcode
|
string null | ja | |
└ house_number
|
integer null | ja |
| 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.