Every request needs an API key, which you can get in the [portal](/portal).

When you call the API from a browser, visitors can see your API key. Limit it to your own domains in the [portal](/portal), or send the requests through your own server so the key stays hidden.


authKey

Deduce a complete or probable address based on incomplete, ambiguous, or partial input.

Validates that an address with the provided fields exists, and provides additional information about it.

If you do not have all required parameters, use the [suggest](#tag/Suggest-LU) call to gather them first.

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

* To validate if an address has either a street number or a premise, query through the `streetNumberAndPremise` field.
* To validate if an address exists with a certain street number, 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 four digits.


postalCode

Luxembourg postalCode

street

streetNumber

The address's street number and premise (extension/addition).


streetNumberAndPremise

premise

A value is malformed, or does not match the address that `addressId` selects.

A parameter the request needs is missing, or the fields match several addresses. In that case `parameter` holds the missing parameter and the values to choose from.

The request is rejected; `error_id` names the reason.


The API key is missing, unknown, revoked or expired, its subscription is not active, the request does not match the key's allowlist, or the subscription does not include this call.

The request is not authorized; `error_id` names the reason.


No result matches the parameters the request sent.

Nothing matches the request; `error_id` names the reason.


Saisie automatique Luxembourg Pas à pas