Address API documentation
One REST API for address autocomplete, validation, postal code lookup, reverse geocoding and distance data in 11 European countries. Use it to complete checkout forms, validate addresses before shipping, find the nearest store or calculate distances between locations.
Adding address autocomplete to your own form? Start with the Infer SDKs
https://api.pro6pp.nl/v2/autocomplete/nl?postalCode=1017AA&streetNumber=4&premise=A&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/be?postalCode=1000&street=Anderlechtsesteenweg&streetNumber=144&box=bus b002&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/lu?postalCode=9766&street=Duerefstrooss&streetNumber=1&premise=A&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/de?postalCode=86975&settlement=Bernbeuren&street=Schwabenstraße&streetNumber=3&premise=a&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/fr?postalCode=06600&settlement=Antibes&street=Rue de la Baume&streetNumber=10&premise=bis&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/dk?postalCode=6430&settlement=Stevning&street=Stevningnorvej&streetNumber=19&premise=A&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/at?postalCode=1100&settlement=Favoriten&street=Eva-Zilcher-Gasse&streetNumber=1&premise=A&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/ch?postalCode=4001&settlement=Basel&street=Marktplatz&streetNumber=30&premise=a&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/es?postalCode=28001&settlement=Madrid&street=Calle goya&streetNumber=1&premise=A&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/gb?postalCode=B1 2JB&settlement=Birmingham City Centre&street=Brindley Place&streetNumber=1&premise=A&authKey=YOUR_API_KEYhttps://api.pro6pp.nl/v2/autocomplete/it?postalCode=20121&settlement=Milano&street=Via Alessandro Manzoni&streetNumber=12&premise=A&authKey=YOUR_API_KEY{
"BAGNumberId": "0363200000543031",
"BAGPremiseId": "0363100012179462",
"BAGPublicSpaceId": "0363300000002701",
"BAGResidenceId": "0363010001172966",
"BAGType": "vbo",
"constructionYear": 1766,
"country": "Netherlands",
"countryCode": "NL",
"district": "Grachtengordel-Zuid",
"lat": 52.36698,
"lng": 4.89398,
"municipality": "Amsterdam",
"neighbourhood": "Rembrandtplein e.o.",
"plotSize": 78,
"postalCode": "1017AA",
"premise": "A",
"province": "Noord-Holland",
"purposes": [
"woonfunctie"
],
"settlement": "Amsterdam",
"street": "Amstel",
"streetNumber": 4,
"surfaceArea": 63
}Example: Autocomplete, NetherlandsTry it
Get started
Three steps to your first response.
Get an API key
Every request needs an API key, which you can get in the portal.
Send a request
Call
https://api.pro6pp.nl/v2with the endpoint path and addauthKeyas a query parameter.Read the response
Every call answers with JSON. Each endpoint page lists the response fields, and you can send an example call to see them.
- Base URL
https://api.pro6pp.nl/v2- Authentication
authKeyquery parameter- Version
- 2.0.0
- Response format
- application/json
- CORS
- Wildcard origin, callable from the browser
- TLS
- We support TLS 1.2 + 1.3 on
api.pro6pp.nl
More about the API
Introduction
This API is documented in OpenAPI format. This API replaces our v1 legacy API over time. See the API deprecation about support durations. All v2 endpoints support an optional trailing slash and serve both forms directly, without a redirect.
Cross-Origin Resource Sharing
This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with W3C spec. And that allows cross-domain communication from the browser. All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.
Authentication
Pro6PP's security is based on an authorization key. You have to supply the query parameter 'authKey' to request data from the API.
Available API Features
Select a country to view its available API calls.
Autocomplete
BetaAutocomplete a Dutch address.
/autocomplete/nlSuggest
BetaSuggest a Dutch address field.
/suggest/nl/postalCode/suggest/nl/settlement/suggest/nl/street/suggest/nl/streetNumberInfer
AlphaSuggest possible Dutch addresses from a string.
/infer/nlDistance
BetaReturn driving distance and time between two Dutch postcodes.
/distance/nlRange
BetaReturn Dutch postal codes within range of a given postal code.
/range/nlLocator
BetaReturn near postcodes from a postcode or latitude/longitude combination.
/locator/nlPOST /locator/nlFeedback
BetaManage addresses missing in the Netherlands.
/feedback/nlPOST /feedback/nlDELETE /feedback/nl/feedback/nl/postcodePOST /feedback/nl/postcodeDELETE /feedback/nl/postcodeReverse Global
BetaReverse a latitude/longitude to an address.
/reverse/globalBuilt for integration
OpenAPI based REST API
Every endpoint of the address validation API is described in a published OpenAPI 3 specification. Use it to generate a typed client for your stack, or read the documentation one endpoint at a time.
Documented error responses
Every endpoint lists the errors it can return, each with its error_id and an example body. Every call returns errors in the same format, so one error handler covers them all.
A stated deprecation window
Nothing is removed without notice. While v2 is in pre-production, deprecations come with at least 6 months' notice; once it is stable, at least 36 months.
Examples in four languages
Every endpoint page has code examples in cURL, JavaScript, Python and PHP for calling the address validation API, plus a request you can send from the page to see the real response.
Use Cases
Webshops - Address Validation & Fast Input
Speed up checkout with auto-filled, validated addresses for quick parcel delivery.
Transport & Taxi - Distance Calculations
Get accurate route distances to optimize travel time and improve fleet planning.
Real Estate - Housing & Plot Data
Access housing size, plot area, and build year to enrich listings and tools.
Retail & Franchise - Location Optimization
Optimize site planning and delivery routes using precise location and distance data.