Autocomplete demo

1 Authentication

The API uses OAuth 2.0 client credentials flow. Authentication is handled server-side — credentials are never sent to your browser.

POST /oauth2/token
grant_type=client_credentials
client_id=••••••••
client_secret=••••••••
Token obtained successfully
eyJraWQiOiJhbHBhZGRyZXNzLWRldi1r…
Credentials are kept server-side. The browser only receives a short-lived access token valid for this session.
2 Search an address

Start typing any Swiss address — street, city, postal code or any combination. Suggestions appear as you type, ranked by relevance.

API Endpoint Used

GET /api/addresses/autocomplete?query=<text>&limit=10&threshold=0.3

Authorization: Bearer <token>

X-HelvAddress-API-Version: 1.0.0

Full API Reference
3 Address Details
🏠

Select an address from the suggestions to see its full details here.

Address Normalization Demo

1 Authentication

Same OAuth 2.0 token used as above — no extra authentication required.

POST /oauth2/token
grant_type=client_credentials
Token obtained successfully
eyJraWQiOiJhbHBhZGRyZXNzLWRldi1r…
Credentials are kept server-side. The browser only receives a short-lived access token valid for this session.
2 Enter a freeform address

Type any Swiss address as a user would — abbreviated, misspelled, or unstructured. The API parses and validates it against the official Swiss federal register.

API Endpoint Used

POST /api/addresses/normalize (Content-Type: text/plain)

Body (text/plain): freeform address string

Full API Reference
3 Normalized Result
🔍

Enter an address and click Normalize to see the structured result here.