The API key is required for all requests and must be included as a query parameter named `authKey`. You can obtain your API key from the [portal](/portal).


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.

In case you don't know all of the required parameters, you can use the [suggest](#tag/Suggest-CH) 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 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

Swiss postalCode

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


settlement

street

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


Autocomplete Switzerland Step by step