# Release Notes

<details>

<summary><mark style="color:$info;">Mai 2026</mark> | Autocomplete: Erweiterter Output, Mehrquellen-Suche &#x26; Metrics/Usage</summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="rOeVRfnSZd1U">Search &#x26; Autocomplete</span></td></tr></tbody></table>

#### Autocomplete mit erweitertem Datenoutput

Der `Search/Autocomplete` Endpoint wurde um neue Ausgabefelder erweitert. Suchergebnisse enthalten nun neben Name und Adresse auch vollständige Kontakt- und Kategoriedaten.

**Neu verfügbare Felder:**

* `dwhId` – Eindeutige Datensatz-ID
* `category` – Branchenkategorie (mehrsprachig: DE, FR, IT, EN)
* `email` – E-Mail-Adresse
* `url` – Website
* `phoneNumbers` – Array mit einer oder mehreren Festnetznummern
* `mobileNumbers` – Array mit einer oder mehreren Mobilnummern

#### Mehrquellen-Suche

Alle Search-Endpoints unterstützen neu die parallele Suche in mehreren Datenquellen. Die gewünschten Quellen werden als kommagetrennte Liste angegeben:

* `consumer` – nur Privatpersonen
* `business` – nur Firmen und Organisationen
* `consumer,business` – Privatpersonen und Firmen

#### Vereinfachte Quellenangabe mit Aliasen

Interne Quellencodes werden durch verständliche Aliase ersetzt:

| Alias      | Beschreibung              |
| ---------- | ------------------------- |
| `consumer` | Privatpersonen            |
| `business` | Firmen und Organisationen |
| `geo`      | Geodaten                  |

Bestehende Implementationen, die eine einzelne Quelle angeben, funktionieren weiterhin ohne Anpassung.

#### Metrics & Usage

Neuer Endpoint `metrics/usage` zur Abfrage der eigenen API-Nutzung. Anfragen und zurückgelieferte Datensätze lassen sich je Funktion und Zeitraum (laufender Monat, Vormonat, laufendes Jahr) abrufen. Die Daten werden täglich aktualisiert und stehen bis zum Vortag (23:59:59 Uhr) zur Verfügung.

</details>

<details>

<summary><mark style="color:$info;">Mär 2026</mark> | Search/Fulltext: Mehr Datentiefe in der Response</summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="rOeVRfnSZd1U">Search &#x26; Autocomplete</span></td></tr></tbody></table>

#### Search/Fulltext: Mehr Datentiefe in der Response

Der [`Search/Fulltext`](/multisource-api/integration/search-and-autocomplete.md#fulltext) Endpoint wurde um zusätzliche Ausgabefelder erweitert. Die Response liefert nun neben Name und Adresse auch Kontakt- und Kategoriedaten, wodurch sich Suchergebnisse direkt für weiterführende Anwendungsfälle nutzen lassen.

**Neu verfügbare Felder:**

* `category` – Branchenkategorie des Eintrags (mehrsprachig: DE, FR, IT, EN)
* `email` – E-Mail-Adresse
* `url` – Website
* `phoneNumbers` – Array mit einer oder mehreren Festnetznummern
* `mobileNumbers` – Array mit einer oder mehreren Mobilnummern

</details>

<details>

<summary><mark style="color:$info;">Feb 2026</mark> | Call Lookup: Flexible Ein- und Ausgabeformate für Telefonnummern</summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="rpQKyld66ShR">Call Lookup</span></td></tr></tbody></table>

#### Call Lookup: Kontrolle über Telefonnummern-Formate

Der Call Lookup Endpoint wurde um neue Formatierungsoptionen erweitert. Telefonnummern können nun sowohl im lokalen Format (ohne Ländervorwahl) als auch im E.164-Format (mit +) übergeben werden. Mit dem optionalen Parameter `outputFormat` steuern Sie zusätzlich, in welchem Format die Telefonnummer zurückgegeben wird:

* **Eingabe:** Beide Formate werden akzeptiert (z.B. `0791234567` oder `+41791234567`)
* **Ausgabe Format 1 (Standard):** Lokales Format ohne Ländervorwahl (z.B. `0791234567`)
* **Ausgabe Format 2:** E.164-Format mit + und Ländervorwahl (z.B. `+41791234567`)

Dies ermöglicht eine bessere Integration in verschiedene Systeme und Use Cases, die spezifische Telefonnummern-Formate erfordern.

**Technische Details:**

* Parameter `number`: Akzeptiert lokales Format und E.164-Format
* Parameter `outputFormat` (integer, optional)
* Standardwert: `1` (lokales Format)
* Werte: `1` = lokal, `2` = E.164

</details>

<details>

<summary><mark style="color:$info;">Jan 2026</mark> | Der multisource Hub – Mehr Transparenz für Ihre API-Nutzung</summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="uLr2ROn5ZTUu">Hub</span></td></tr></tbody></table>

#### multisource Hub

Wir ergänzen die multisource•api mit dem neuen **multisource Hub**. Das neue Portal dient Ihnen als zentrale Anlaufstelle, um jederzeit Einblick in Ihre Verarbeitungen und Kosten zu erhalten.

In dieser ersten Version liegt der Fokus auf der Bereitstellung detaillierter Informationen und Statistiken zu Ihren Aktivitäten.

#### Die Funktionen im Überblick:

* **Zentrales Dashboard:** Übersicht über Ihre täglichen und monatlichen Requests sowie die aktuellen monatlichen Kosten.
* **Batch-Monitoring:** Einsicht in den Status Ihrer Adressverarbeitungen inklusive Verarbeitungsdauer und Datensatz-Anzahl.
* **Detaillierte FactSheets:** Pro Batch steht Ihnen ein Detailreport zum Abruf bereit.
* **Aktualisierungs-Statistiken:** Grafische Aufbereitung der verarbeiteten Status (z. B. Umzüge, Verstorbene oder neue Referenzdaten).
* **Kostenübersicht:** Transparente Darstellung der Kostenhistorie vergangener Monate.

#### Ausblick: Die Zukunft des Hubs

Dies ist erst der Anfang. Wir planen, den multisource Hub kontinuierlich zu erweitern, um Ihnen künftig noch mehr Flexibilität zu bieten. Freuen Sie sich auf kommende Features wie:

* **Self-Service Verwaltung:** Management Ihrer API-Keys und Benutzerzugänge direkt im Portal.
* **Konfigurations-Optionen:** Erweiterte Möglichkeiten, Ihre Verarbeitungen direkt über das Web-Interface zu steuern.

</details>

<details>

<summary> <mark style="color:$info;">Nov 2025</mark> | Call Lookup: Quellenabfrage, Vereinfachtes Adressprocessing</summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="rpQKyld66ShR">Call Lookup, </span><span data-option="iDNf9mp6HzGz">Validate &#x26; Update, </span><span data-option="broj50UnKv8x">Enrich</span></td></tr></tbody></table>

#### Call-Lookup: Automatische Quellenabfrage

Der Call-Lookup Endpoint wurde vereinfacht. Alle Anfragen durchsuchen nun automatisch die Quellen ETC und ETB und liefern einen aggregierten Datensatz zurück. Die manuelle Angabe einer Quelle entfällt.

#### AddressProcessing/Create: Vereinfachte Batch-Erstellung

Der Batch-Erstellungsprozess wurde optimiert. Batches können nun direkt über den Create-Endpoint angelegt werden, ohne dass vorab eine Datagroup erstellt werden muss. Zusätzlich akzeptiert der Endpoint neu ein settings-Property, wodurch Batch-Settings direkt bei der Erstellung übergeben werden können. Ein separater Aufruf von SetBatchSettings entfällt damit.

#### GetRecords: Flexible Ausgabeformate

GetRecords unterstützt neu die Wahl zwischen Datei- und JSON-Format und ist nun die empfohlene Methode für den Zugriff auf AddressResult-Daten. FileDownload bleibt für spezielle Anwendungsfälle weiterhin verfügbar.

</details>

<details>

<summary> <mark style="color:$info;">Sep 2025</mark> | Neue Output-Formate</summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="iDNf9mp6HzGz">Validate &#x26; Update, </span><span data-option="broj50UnKv8x">Enrich</span></td></tr></tbody></table>

#### Neue Output-Formate

Neu stehen beim **AdressProcessing** zusätzliche Optionen für das Output-Format zur Verfügung:

* Beim Endpoint `/AdressProcessing/FileDownload` kann gewählt werden, ob die Datei **komprimiert (.txt.gz)** oder **unkomprimiert (.txt)** ausgeliefert wird.
* Standardwert: **komprimiert** (false)
* Optional: **unkomprimiert** (true)
* Mit dem neuen Endpoint `/AdressProcessing/GetRecords` können die Resultate auch direkt als **JSON** abgerufen werden.

</details>

<details>

<summary> <mark style="color:$info;">Jun 2025</mark> | Mehr Möglichkeiten in den Batch Settings </summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="iDNf9mp6HzGz">Validate &#x26; Update, </span><span data-option="broj50UnKv8x">Enrich</span></td></tr></tbody></table>

#### Ersetzung von SetBatchSetting durch SetBatchSettings

* Die neue Funktion **SetBatchSettings** ersetzt die bisherige SetBatchSetting-Methode vollständig. Sie bietet eine klarere und flexiblere Möglichkeiten zur Konfiguration mehrerer Einstellungen in einem einzigen Aufruf.
* Anstelle einzelner Parameter akzeptiert SetBatchSettings nun eine strukturierte Liste im Request-Body, wodurch mehrere Konfigurationswerte effizient in einem Schritt übergeben werden können.
* Die Funktion vereinfacht insbesondere die Anwendung von Einstellungen für Business-Cases und sorgt für eine konsistentere Nutzung innerhalb der API.

</details>

<details>

<summary> <mark style="color:$info;">Mai 2025</mark> | Call Lookup &#x26; Flexible Batch-Verarbeitung &#x26; Auth-Key</summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="rpQKyld66ShR">Call Lookup, </span><span data-option="rOeVRfnSZd1U">Search &#x26; Autocomplete, </span><span data-option="iDNf9mp6HzGz">Validate &#x26; Update, </span><span data-option="broj50UnKv8x">Enrich</span></td></tr></tbody></table>

Die API-Version 1.1 bringt ein neues Modul (Call Lookup) sowie erweiterte Funktionen für Adress Processing, Sicherheit und Konfigurierbarkeit.

#### Call Lookup (Rückwärtssuche für Telefonnummern)

Neue Lookup-Funktionalität: Ermöglicht die gezielte Rückwärtssuche anhand von Telefonnummern.

#### Address Processing: SetBatchSetting mit Typ „99 - Dictionary“

Einführung eines neuen Setting-Typs, der flexible Konfigurationen im JSON-Format erlaubt.\
Typische Anwendungsfälle: Trigger für Webhooks (z. B. Airflow), gezieltes Ausschliessen bestimmter Datenquellen etc.

#### Address Processing: AddRecords

Neuer Endpunkt zur Ergänzung von Datensätzen in bestehenden Batches per HTTP PUT.\
Voraussetzung: Der Batch muss sich im Status created befinden.\
Diese Methode ergänzt die bisherige Datei-basierte Einspielung um eine API-basierte Variante.

#### Personal Access Tokens (PAT)

Einführung eines neuen Authentifizierungsverfahrens über PATs, die im Portal generiert und verwaltet werden können. Sie bieten eine Alternative zum klassischen Bearer-Token-Modell.

**Nutzung:**\
Statt Authorization: Bearer wird das Token nun im Header mit auth-key übermittelt.

</details>

<details>

<summary> <mark style="color:$info;">Jan 2025</mark> | Einführung multisource•api</summary>

<table><thead><tr><th>Module in diesem Release<select multiple><option value="rpQKyld66ShR" label="Call Lookup" color="blue"></option><option value="rOeVRfnSZd1U" label="Search &#x26; Autocomplete" color="blue"></option><option value="iDNf9mp6HzGz" label="Validate &#x26; Update" color="blue"></option><option value="broj50UnKv8x" label="Enrich" color="blue"></option><option value="uLr2ROn5ZTUu" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="rOeVRfnSZd1U">Search &#x26; Autocomplete, </span><span data-option="iDNf9mp6HzGz">Validate &#x26; Update, </span><span data-option="broj50UnKv8x">Enrich</span></td></tr></tbody></table>

Die erste Version der multisource•api bildet das Fundament für die automatisierte Pflege, Anreicherung und Suche von Adress- und Personendaten auf Basis verlässlicher Schweizer Quellen.

#### Authentifizierung

* Sicherer Zugriff auf die API über Bearer Token.

#### Validate & Update

* Echtzeit-Validierung und Korrektur von Adressen direkt aus operativen Systemen (z. B. CRM, Kampagnenmanagement).
* Erkennung von Adressänderungen, Todesfällen, Umzügen, Dubletten und falschen Adressbestandteilen.
* Nutzung mehrerer Quellen (Umzugsdaten, Verzeichnisse, Gebäuderegister) für maximale Datenqualität.

#### Enrich

* Anreicherung bestehender Datensätze mit strukturierten Zusatzinformationen.

#### Search & Autocomplete

* Intelligente Suche nach Personen oder Firmen auf Basis von Teilinformationen.
* Autovervollständigung für Adressen – ideal für Formularfelder (Web, App, CRM).

#### Batch-Verarbeitung

* Verarbeitung grosser Datenmengen über leistungsfähige Verarbeitungs-Engine.

#### Datenhaltung & Datenschutz

* Verarbeitung der Daten erfolgt ausschliesslich in der Schweiz – DSG-konform.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://multisource.gitbook.io/multisource-api/mehr/release-notes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.