Netherlands postcode API
Find the full address from a postcode and house number.
Find the matching street and city using only the Dutch postcode and house number via the API or our widget.
The first 500 requests per month are free.
Two fields are enough
Enter the postcode and house number. Spaces and letter casing in the postcode do not matter.
Street, city and house number additions
A match returns structured address fields. House number additions available? Let the customer choose from the options.
One request. Structured JSON.
Use a publishable API key for frontend requests and a secret key for backend requests when needed.
curl --get 'https://places-api.com/api/v1/lookup' \ -H 'X-API-Key: YOUR_API_KEY' \ --data-urlencode 'postcode=1012JS' \ --data-urlencode 'housenumber=1' \ --data-urlencode 'country=NL'
{
"status": "found",
"address": {
"street": "Dam",
"housenumber": "1",
"housenumber_addition": null,
"postcode": "1012JS",
"city": "Amsterdam",
"country": "NL"
}
}
Without a house number, you get postcode information with a house number range, not a complete address. Also handle invalid input, authentication errors and HTTP 429 for rate limits.
View the docsBuilt on the official BAG register
Dutch address data comes from Kadaster's Basisregistratie Adressen en Gebouwen (BAG), the official register of addresses and buildings. We refresh our data from new publications.
Start small, grow from there
Start free with 500 requests per month. Starter includes 5.000 requests for €9 per month, excluding VAT. Quotas and rate limits apply to your API usage.