← API catalog

Dutch address lookup

$0.005 / call
GET /api/v1/nl/address

Resolve a Dutch postcode + house number to a full address (street, city, gemeente, province, WGS84 + RD coordinates), or reverse-geocode coordinates to the nearest address.

Parameters

NameRequiredDescription
postcodenoDutch postcode, e.g. 1011AC (forward lookup; with huisnummer).
huisnummernoHouse number (forward lookup; with postcode).
latnoWGS84 latitude (reverse lookup; with lon).
lonnoWGS84 longitude (reverse lookup; with lat).
samplenoQuery param on GET; set to 1 for the free demo response.

Free sample

curl https://api.agenticweb.nl/api/v1/nl/address?sample=1

Paid call

Returns 402 Payment Required; pay over x402 and retry.

curl -X POST https://api.agenticweb.nl/api/v1/nl/address \
  -H 'Content-Type: application/json' \
  -d '{"postcode":"1011AC","huisnummer":128}'

This endpoint takes its parameters in a JSON request body rather than the query string, because they are personal data and a request URL is recorded in server access logs. A GET without ?sample=1 returns 405.

Licensing

Public Domain Mark 1.0 (BAG via PDOK); free for commercial reuse.

Forward needs postcode + huisnummer; reverse needs lat + lon. Reverse responses include distance_m.