Geef een Nederlandse postcode (bijv. 1011AB) op en ontvang straatnaam, stad, gemeente en GPS-coördinaten. Voeg optioneel een huisnummer toe voor een exactere adresopzoeking.
Vul straat en woonplaats automatisch in zodra een gebruiker een postcode invoert.
Controleer of het ingevoerde adres klopt vóór opslag in je ordersysteem.
Gebruik de coördinaten om te bepalen of een adres binnen een bepaalde bezorgradius valt.
De API dekt de volledige Nederlandse postcoderuimte. Bij postcodes in nieuwbouwwijken kan dekking iets achterlopen op de actualiteit van de bron.
Zonder huisnummer retourneert de API postcodeniveau-data (straat + woonplaats). Met huisnummer probeert de API het exacte adres terug te geven.
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/lookup/postcode?postcode=1234AB&number=12" \
--header "X-Api-Key: ga_live_YOUR_KEY"
const response = await fetch('https://api.getapi.nl/api/v1/lookup/postcode?postcode=1234AB&number=12', {
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/lookup/postcode?postcode=1234AB&number=12',
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',
'number': '12',
}
response = requests.get('https://api.getapi.nl/api/v1/lookup/postcode', headers=headers, params=params)
data = response.json()
{
"found": true,
"postcode": "1011AB",
"street": "De Ruijterkade",
"city": "Amsterdam",
"municipality": "Amsterdam",
"number": null,
"lat": 52.37779461,
"lon": 4.90564828
}
Overzicht van alle velden die de API teruggeeft in een succesvol antwoord.
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
found
|
boolean | nee | |
postcode
|
string | nee | |
street
|
string | nee | |
city
|
string | nee | |
municipality
|
string | nee | |
number
|
null | nee | |
lat
|
number | nee | |
lon
|
number | nee |
| Tier | Rate limit | Kosten per call |
|---|---|---|
| Gratis | 5 verzoeken/min | 1.00 credit |
| Betaald | 250 verzoeken/min | 1.00 credit |
| Premium | 250 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.