Skip to content Skip to sidebar Skip to footer
Inloggen

Search – Belgium

Close

Search API - Belgium

Introduction

For Belgium postal codes, and numbers are NOT unique to an address. So read the below endpoints carefully.

Supported search endpoints:

City

URL parameters:

  • name (required)
  • limit (optional, number (default=25))
Example request:

GET https://api.apicheck.nl/search/v1/city/be?name=Dinant

{
    "error": false,
    "data": {
        "Country": {
            "name": "België",
            "code": "BE",
            "nameInt": "Belgium"
        },
        "Results": [
            {
                "name": "Dinant",
                "city_id": 229,
                "Postalcodes": [
                    {
                        "name": 5503,
                        "postalcode_id": 250
                    },
                    {
                        "name": 5500,
                        "postalcode_id": 247
                    },
                    {
                        "name": 5504,
                        "postalcode_id": 251
                    },
                    {
                        "name": 5501,
                        "postalcode_id": 248
                    },
                    {
                        "name": 5502,
                        "postalcode_id": 249
                    }
                ]
            }
        ]
    },
    "count": 1
}
Postalcode

URL parameters:

  • name (required)
  • limit (optional, number (default=25))

Note: postalcodes are not unique in France. You can use this endpoint to refine searches to specific areas.

Example request:

GET https://api.apicheck.nl/search/v1/postalcode/be?name=5503

{
    "error": false,
    "data": {
        "Country": {
            "name": "België",
            "code": "BE",
            "nameInt": "Belgium"
        },
        "Results": [
            {
                "name": 5503,
                "postalcode_id": 250,
                "City": {
                    "name": "Dinant",
                    "city_id": 229
                }
            }
        ]
    },
    "count": 1
}
Street

URL parameters:

  • name (required)
  • city_id (optional)
  • postalcode_id (optional)
  • limit (optional, number (default=25))
Note: city_id and postalcode_id are both optional parameters. However to refine your search within a specified city you can provide a city_id and/or postalcode_id. If you provide both your query will have better results as the search area is smaller. To obtain these IDs you can use the above City or Postalcode search endpoint.
 
Example request:

GET https://api.apicheck.nl/search/v1/street/be?city_id=229&postalcode_id=250&name=Rue

{
    "error": false,
    "data": {
        "Country": {
            "name": "België",
            "code": "BE",
            "nameInt": "Belgium"
        },
        "Results": [
            {
                "name": "Rue de Taviet ",
                "street_id": 22954,
                "City": {
                    "name": "Dinant",
                    "city_id": 229
                }
            },
            {
                "name": "Rue Saint-Rémy",
                "street_id": 22955,
                "City": {
                    "name": "Dinant",
                    "city_id": 229
                }
            },
            {
                "name": "Rue de Gorimont ",
                "street_id": 22956,
                "City": {
                    "name": "Dinant",
                    "city_id": 229
                }
            },
        ]
    },
    "count": 19
}
Verify / lookup full address

This endpoint is used to validate the full given address. All parameters are optional. The results will show as an array, as there can be multiple results.

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/be?number=1&city_id=229&postalcode_id=247&street_id=28157

{
    "error": false,
    "data": {
        "Country": {
            "name": "België",
            "code": "BE",
            "nameInt": "Belgium"
        },
        "Results": [
            {
                "street": "Citadelle",
                "number": "1",
                "numberAddition": null,
                "postalcode": 5500,
                "city": "Dinant",
                "municipality": "Dinant",
                "region": "Wallonie",
                "formattedAddress": "Citadelle 1 5500 Dinant Wallonie, Belgium",
                "Location": {
                    "Coordinates": {
                        "latitude": "50.261870493331",
                        "longitude": "4.9127567001269"
                    }
                }
            }
        ]
    },
    "count": 1
}

Run and try out in Postman: