Skip to content Skip to sidebar Skip to footer

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: