Search API -The Netherands
Introduction
For The Netherlands, a postalcode and a number (optionally a suffix) are unique to an address.
Supported search endpoints:
City
URL parameters:
- name (required)
- limit (optional, number (default=25))
Example request:
GET https://api.apicheck.nl/search/v1/city/nl?name=Utrecht
{
"error": false,
"data": {
"Country": {
"name": "Nederland",
"code": "NL",
"nameInt": "The Netherlands"
},
"Results": [
{
"name": "Utrecht",
"city_id": 2289,
"Postalcodes": null
}
]
},
"count": 1
}
Street
URL parameters:
- name (required)
- limit (optional, number (default=25))
Example request:
GET https://api.apicheck.nl/search/v1/street/nl?name=Hoog cath&city_id=2289
{
"error": false,
"data": {
"Country": {
"name": "Nederland",
"code": "NL",
"nameInt": "The Netherlands"
},
"Results": [
{
"name": "Hoog Catharijnepassage",
"street_id": 85223,
"City": {
"name": "Utrecht",
"city_id": 2289
}
}
]
},
"count": 1
}
Postalcode
URL parameters:
- name (required)
- limit (optional, number (default=25))
Note: postalcodes are unique in The Netherlands. So no postalcode_id is shown. You can use city_id as unique value.
Example request:
GET https://api.apicheck.nl/search/v1/postalcode/nl?name=3511DX&city_id=2289
{
"error": false,
"data": {
"Country": {
"name": "Nederland",
"code": "NL",
"nameInt": "The Netherlands"
},
"Results": [
{
"name": "3511DX",
"postalcode_id": null,
"City": {
"name": "Utrecht",
"city_id": 2289
}
}
]
},
"count": 1
}
Verify / lookup full address
URL parameters:
- number (optional)
- numberAddition (optional)
- street_id (optional)
- city_id (optional)
- limit (optional, number (default=25))
Example request:
GET https://api.apicheck.nl/search/v1/address/nl?city_id=2289&number=1&street_id=85223
{
"error": false,
"data": {
"Country": {
"name": "Nederland",
"code": "NL",
"nameInt": "The Netherlands"
},
"Results": [
{
"street": "Hoog Catharijnepassage",
"number": "1",
"numberAddition": null,
"postalcode": "3511WP",
"city": "Utrecht",
"municipality": "Utrecht",
"region": null,
"formattedAddress": "Hoog Catharijnepassage 1 3511WP Utrecht, The Netherlands",
"Location": {
"Coordinates": {
"latitude": "52.091707581737",
"longitude": "5.1142844596263"
}
}
}
]
},
"count": 1
}
Run and try out in Postman: