Preview · This help is still growing and will be extended over time.

Integration · Administrator

Configure the search.ch integration

Identifying callers from the public Swiss directory

Updated: November 2026

With the search.ch integration, echo also identifies callers who are not in any of your own systems: echo looks up the number in the public Swiss directory of search.ch, with entries for people, companies and authorities. A directory entry for a person appears as a person in echo, an entry for a company or authority as a company, each with phone numbers, email addresses, websites and address as listed in the directory.

The integration is set up once by an administrator and applies to the whole organization. You need your own search.ch API key.

Things to know:

Prerequisites

Set up search.ch

1

Request an API key

Request an API key from search.ch at search.ch/tel/api/getkey.en.html (opens in a new tab). The link is also shown on the settings page in echo.

2

Enter the key

Open Settings → search.ch and paste the key into 1 API Key. echo checks the key right away by sending a test query to search.ch and shows 2 API Key is valid or API Key is invalid.

Fig. 1: Settings → search.ch with a validated API key.
3

Save

Click 3 Save. The button is only active once the key has been confirmed as valid. echo stores the key encrypted; afterwards the field shows a placeholder instead of the key.

From now on echo includes search.ch in every caller lookup and contact search.

Change or remove the key

To replace the key, click into API Key, enter the new key, wait for API Key is valid and click Save. If you leave the field without typing, the saved key stays unchanged.

To stop using search.ch, remove the integration at the bottom of the page under Remove integration (see How integrations work).

Troubleshooting

The page says search.ch is not enabled. Add search.ch under Settings → Integrations first.

The search.ch settings are missing. Integration settings are only shown to administrators; ask one of them.

“API Key is invalid”. Check that you copied the complete key without spaces. If it is still rejected, request a new key at search.ch.

The integration shows Not configured. No API key has been saved yet. echo does not search search.ch until a key is saved.

Callers are suddenly no longer recognized at all. If search.ch rejects the saved key (for example because it was revoked), the whole caller lookup can fail. Enter a valid key or remove the integration.

A Swiss caller is not found. Check on search.ch whether the number has a public entry. Entries changed in the last 24 hours may not be visible in echo yet.