Documentation REST
Geo Adrescheck Nationaal
Summary
Simply use the API to enrich Dutch address data that is entered in your webshop or CRM.
Method
The following methods are defined within the Geo Adrescheck Nationaal.
| Method | Description |
| https://api.postnl.nl/address/national/v1/geocode | API that validates national addresses in a general format (send any of a list of pre-defined fields). |
Use of services
Calling a service
A service is called by sending a message to a service endpoint. The message contains a header with security information (API-key) and the content type. The body contains the service method and related parameters.
Each message that is received by the API is authenticated and authorized. The authorization mechanism determines if the user has access to the requested service.
After processing the request, the service will return a message with a response. The message contains a body with the information.
Parameter specification / field order
For each API, the parameters of a service are specified. Also, the behavior of these parameters are detailed. It is important to maintain the exact order of the fields as specified in the documentation. Changing the order of fields will result in unspecified errors returned back at the client.
Security information
Each service is secured with an API-key. You can find your API-key in API Manager. Quotamanager is secured with a username and password. If you don’t have credentials for Quotamanager yet, please fill in the form on this link.
Call details
Preview the API call buildup below.
Method: https://api.postnl.nl/address/national/v1/geocode
Input
{
"PostalCode": "2132WT",
"City": "Hoofddorp",
"Street": "Siriusdreef",
"HouseNumber": "42",
"Addition": "A"
}Output
[
{
"City": "HOOFDDORP",
"PostalCode": "2132WT",
"Street": "Siriusdreef",
"HouseNumber":42,
"Addition": "A",
"FormattedAddress": [
"Siriusdreef 42 A",
"2132WT HOOFDDORP"
}
],
"Geocode": {
"latitude": 12.345678,
"longitude": 1.2345,
"rdxCoordinate": 123456.78,
"rdyCoordinate": 123456.789
}
}
]Requests
| Attribute | Mandatory | Format | Description | Example |
| Country | String [2] | The ISO2 country codes | NLD | |
| Street | String [0-95] | The street name of the delivery address. | Siriusdreef | |
| HouseNumber | String [0-35] | The house number of the delivery address | 42 | |
| Addition | String [0-35] | House number extension | A | |
| PostalCode | String [4-10] | Zipcode of the address | 2132WT | |
| City | String [0-35] | City of the address | Hoofddorp |
The following output parameters are returned:
| Attribute | Format | Description | Example |
| Street | String [0-95] | The street name of the delivery address. | Siriusdreef |
| HouseNumber | String [0-35] | The house number of the delivery address | 42 |
| Addition | String [0-35] | House number extension | A |
| PostalCode | String [4-10] | Zipcode of the address | 2132WT |
| City | String [0-35] | City of the address | HOOFDDORP |
| FormattedAddress | 3 Strings [0-95] | Full formatted address | Siriusdreef 42 A 2132WT HOOFDDORP |
| rdxCoordinate | Strings [10] | Rijksdriehoek coordinate | 199735 |
| rdyCoordinate | Strings [10] | Rijksdriehoek coordinate | 307365 |
| latitude | Strings [10] | LatLong coordinate | 52.09061 |
| longitude | Strings [10] | LatLong coordinate | 5.12143 |