In case you don't know all of the required parameters, you can use the [suggest](#tag/Suggest-BE) call to gather them first.

If the input identifies a unique address, all available information
about said address is returned. The default street, settlement,
province will be in the language spoken for that region. E.g: For
settlement, province and region in Flanders the default is Dutch.
In Wallonia the default language spoken is French, except for German
speaking parts where the default is German.

* To validate if an address has either a streetNumber or a Premise, query through the `streetNumberAndPremise` field.
* To validate if an address exists with a certain streetnumber, use the `streetNumber` field.
* To validate if an address exists with a certain premise, use both the `streetNumber` and `premise` fields.
* Either `streetNumberAndPremise` or `streetNumber` is required. If both are given, only `streetNumber` is used.


The address's postal code which can be up to four digits long


postalCode

Belgium postalCode

street

The address's streetnumber and premise (extension/addition)


streetNumberAndPremise

streetNumber

premise

The box (without box, bus, bte or boîte prefix)


In case you don't know all of the required parameters, you can use the [suggest](#tag/Suggest-DE) call to gather them first.

If the input identifies a unique address, all available information
about said address is returned.

* To validate if an address has either a streetNumber or a Premise, query through the `streetNumberAndPremise` field.
* To validate if an address exists with a certain streetnumber, use the `streetNumber` field.
* To validate if an address exists with a certain premise, use both the `streetNumber` and `premise` fields.
* Either `streetNumberAndPremise` or `streetNumber` is required. If both are given, only `streetNumber` is used.


The address's postal code which can be up to five digits long


German postalCode

The address's settlement (city, town, village, or hamlet)


settlement

In case you don't know all of the required parameters, you can use the [suggest](#tag/Suggest-NL) call to gather them first.

If the input identifies a unique address, all available information
about said address is returned.

* To validate if an address has either a streetNumber or a Premise, query through the `streetNumberAndPremise` field.
* To validate if an address exists with a certain streetnumber, use the `streetNumber` field.
* To validate if an address exists with a certain premise, use both the `streetNumber` and `premise` fields.
* Either `streetNumberAndPremise` or `streetNumber` is required. If both are given, only `streetNumber` is used.

The specials subscription offers extra return fields these are:

* BAG_NUM_ID
* BAG_OPR_ID
* BAG_PND_ID
* BAG_VBO_ID
* BAG_TYPE
* neighbourhood
* district


The address's postal code in sixpp format (1000AA)


Dutch postalCode

In case you don't know all of the required parameters, you can use the [suggest](#tag/Suggest-LU) call to gather them first.

If the input identifies a unique address, all available information
about said address is returned.

* To validate if an address has either a streetNumber or a Premise, query through the `streetNumberAndPremise` field.
* To validate if an address exists with a certain streetnumber, use the `streetNumber` field.
* To validate if an address exists with a certain premise, use both the `streetNumber` and `premise` fields.
* Either `streetNumberAndPremise` or `streetNumber` is required. If both are given, only `streetNumber` is used.


Luxembourg postalCode

In case you don't know all of the required parameters, you can use the [suggest](#tag/Suggest-FR) call to gather them first.

If the input identifies a unique address, all available information
about said address is returned.

* To validate if an address has either a streetNumber or a Premise, query through the `streetNumberAndPremise` field.
* To validate if an address exists with a certain streetnumber, use the `streetNumber` field.
* To validate if an address exists with a certain premise, use both the `streetNumber` and `premise` fields.
* Either `streetNumberAndPremise` or `streetNumber` is required. If both are given, only `streetNumber` is used.


The address's postal code which consists of five digits


French postalCode

webshop

regular

devagency

specials

This will give autocomplete suggestions for postal codes.


The partial postalCode contains at least 1 digit.


Partial postalCode

The amount of results returned, a number between 0 and 999.


maxResults

The page to return, the variables for the next/previous pages can be found in the results Link header.


cursor

This will give autocomplete suggestions for Belgian postal codes.


This will give autocomplete suggestions for French postal codes.


This will give autocomplete suggestions for Luxembourg postal codes.


This will give autocomplete suggestions for settlements.


This will give autocomplete suggestions for Belgian settlements.
Settlements will be returned based on postnames, postnames are (unofficial) cities within a settlement, e.g: Laken is a postname in Brussel.


This will give autocomplete suggestions for French settlements.


This will give autocomplete suggestions for Luxembourg settlements.


This will give autocomplete suggestions for streets.


This will give autocomplete suggestions for Belgian streets.


This will give autocomplete suggestions for French streets.


This will give autocomplete suggestions for Luxembourg streets.


The address's settlement (city, town, village)


This will give autocomplete suggestions for Dutch
streetnumber and premise (extension/addition).

No specific parameter is required but a call must contain at least one of the following parameters:
* `postalCode`
* `street` and `settlement`


This will give autocomplete suggestions for German
streetnumber and premise (extension/addition).


This will give autocomplete suggestions for Belgian
streetnumber and premise (extension/addition).

Only street is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


This will give autocomplete suggestions for French
streetnumber and premise (extension/addition).

Only street is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


This will give autocomplete suggestions for Luxembourg
streetnumber and premise (extension/addition).

Only the `street` parameter is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`

A request cannot be only a streetNumberAndPremise


This will give autocomplete suggestions for streetnumbers.

No specific parameter is required but a call must contain at least one of the following parameters:
* `postalCode`
* `street` and `settlement`


This will give autocomplete suggestions for streetnumbers.


This will give autocomplete suggestions for Belgian streetnumbers.

Only street is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


This will give autocomplete suggestions for French streetnumbers.

Only street is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


This will give autocomplete suggestions for Luxembourg streetnumbers.

Only the `street` parameter is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


This will give autocomplete suggestions for premises.

No specific parameter is required but a call must contain at least one of the following parameters:
* `postalCode`
* `street` and `settlement`


This will give autocomplete suggestions for premises.


This will give autocomplete suggestions for Belgian premises.

Only street is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


This will give autocomplete suggestions for French premises.

Only street is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


This will give autocomplete suggestions for Luxembourg premises.

Only the `street` parameter is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


This will give autocomplete suggestions for Belgian post boxes.

Only street is required but a call must contain at least one of the following parameters:
* `postalCode`
* `settlement`


Postcode databases

Address validation and autocompletion

Try now for free

Fast, reliable & cost effective

Multiple countries

Offline download

Integration

Packages

standard

big

business

Start your 2 month free trial now

Webshops

Trusted by