# Release Notes

<details>

<summary> <mark style="color:$info;">May</mark> <mark style="color:$info;">2026</mark> | Autocomplete: Extended Output, Multi-Source Search &#x26; Metrics/Usage</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="UgeuWW250feg">Search &#x26; Autocomplete</span></td></tr></tbody></table>

#### Autocomplete with Extended Data Output

The `Search/Autocomplete` endpoint has been extended with new output fields. Search results now include complete contact and category data in addition to name and address.

**Newly available fields:**

* `dwhId` – Unique record ID
* `category` – Industry category (multilingual: DE, FR, IT, EN)
* `email` – Email address
* `url` – Website
* `phoneNumbers` – Array of one or more landline numbers
* `mobileNumbers` – Array of one or more mobile numbers

#### Multi-Source Search

All Search endpoints now support parallel searching across multiple data sources. The desired sources are specified as a comma-separated list:

* `consumer` – private individuals only
* `business` – companies and organisations only
* `consumer,business` – private individuals and companies

#### Simplified Source Names with Aliases

Internal source codes are replaced by human-readable aliases:

| Alias      | Description                 |
| ---------- | --------------------------- |
| `consumer` | Private individuals         |
| `business` | Companies and organisations |
| `geo`      | Geodata                     |

Existing implementations specifying a single source continue to work without any changes.

#### Metrics & Usage

New `metrics/usage` endpoint to query your own API usage. Requests sent and data elements returned can be retrieved by function and time period (current month, previous month, current year). Data is updated daily and reflects activity up to the previous day (23:59:59).

</details>

<details>

<summary> <mark style="color:$info;">Mar 2026</mark> | Search/Fulltext: Extended Output Fields</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="UgeuWW250feg">Search &#x26; Autocomplete</span></td></tr></tbody></table>

#### Call Lookup: Control Over Phone Number Formats

The [`Search/Fulltext`](/multisource-integration-api/integration/search-and-autocomplete.md#fulltext) endpoint has been extended with additional output fields. The response now includes contact and category data alongside name and address, allowing search results to be used directly for further use cases.

**Newly available fields:**

* `category` – Industry category of the entry (multilingual: DE, FR, IT, EN)
* `email` – Email address
* `url` – Website
* `phoneNumbers` – Array with one or more landline numbers
* `mobileNumbers` – Array with one or more mobile numbers

</details>

<details>

<summary> <mark style="color:$info;">Feb 2026</mark> | Call Lookup: Flexible Input and Output Formats for Phone Numbers</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="dTl38IFzsg9m">Call Lookup</span></td></tr></tbody></table>

#### Call Lookup: Control Over Phone Number Formats

The Call Lookup endpoint has been enhanced with new formatting options. Phone numbers can now be submitted in both local format (without country code) and E.164 format (with +). Using the optional `outputFormat` parameter, you can additionally control the format in which the phone number is returned:

* **Input:** Both formats are accepted (e.g., `0791234567` or `+41791234567`)
* **Output Format 1 (Default):** Local format without country code (e.g., `0791234567`)
* **Output Format 2:** E.164 format with + and country code (e.g., `+41791234567`)

This enables better integration into various systems and use cases that require specific phone number formats.

**Technical Details:**

* Parameter `number`: Accepts local format and E.164 format
* Parameter `outputFormat` (integer, optional)
* Default value: `1` (local format)
* Values: `1` = local, `2` = E.164

</details>

<details>

<summary> <mark style="color:$info;">Jan 2026</mark> | The multisource Hub – More transparency for your API usage</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="C1kP62OEyxQq">Hub</span></td></tr></tbody></table>

#### multisource Hub

We are enhancing the multisource•api with the new **multisource Hub**. This new portal serves as your central point of contact to view your processing activities and costs at any time.

In this first version, the focus is on providing detailed information and statistics regarding your activities.

#### Features at a glance:

* **Central Dashboard:** Overview of your daily and monthly requests as well as current monthly costs.
* **Batch Monitoring:** Insight into the status of your address processing, including processing duration and record counts.
* **Detailed FactSheets:** A detailed report is available for download for each batch.
* **Update Statistics:** Graphical representation of processed statuses (e.g., relocations, deceased, or new reference data).
* **Cost Overview:** Transparent display of cost history from previous months.

#### Outlook: The Future of the Hub

This is just the beginning. We plan to continuously expand the multisource Hub to offer you even more flexibility in the future. Look forward to upcoming features such as:

* **Self-Service Management:** Manage your API keys and user access directly in the portal.
* **Configuration Options:** Enhanced possibilities to control your processing directly via the web interface.

</details>

<details>

<summary> <mark style="color:$info;">Nov 2025</mark> | Call Lookup: Source Querying, Simplified Address Processing</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="dTl38IFzsg9m">Call Lookup, </span><span data-option="vd8atzWlB99a">Validate &#x26; Update, </span><span data-option="aZKMlh4qtgFg">Enrich</span></td></tr></tbody></table>

#### Call Lookup: Automatic Source Querying

The Call Lookup endpoint has been simplified. All requests now automatically query the ETC and ETB sources and return an aggregated dataset. Manual source specification is no longer required.

#### AddressProcessing/Create: Simplified Batch Creation

The batch creation process has been optimized. Batches can now be created directly via the Create endpoint without requiring prior datagroup creation. Additionally, the endpoint now accepts a settings property, allowing batch settings to be passed directly during creation. A separate call to SetBatchSettings is no longer necessary.

#### GetRecords: Flexible Output Formats

GetRecords now supports choosing between file and JSON format and is the recommended method for accessing AddressResult data. FileDownload remains available for special use cases.

</details>

<details>

<summary> <mark style="color:$info;">Sep 2025</mark> | New Output Formats</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="vd8atzWlB99a">Validate &#x26; Update, </span><span data-option="aZKMlh4qtgFg">Enrich</span></td></tr></tbody></table>

#### New Output Formats

New output format options are now available for **AdressProcessing:**

* With the endpoint `/AdressProcessing/FileDownload`, you can now choose whether the file is delivered **compressed (.txt.gz)** or **uncompressed (.txt)**.
* Default: **compressed** (false)
* Optional: **uncompressed** (true)
* The new endpoint `/AdressProcessing/GetRecords` allows you to retrieve the results directly as **JSON**.

</details>

<details>

<summary> <mark style="color:$info;">Jun 2025</mark> | More flexibility in Batch Settings</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="dTl38IFzsg9m">Call Lookup, </span><span data-option="UgeuWW250feg">Search &#x26; Autocomplete, </span><span data-option="aZKMlh4qtgFg">Enrich</span></td></tr></tbody></table>

#### Replacement of SetBatchSetting with SetBatchSettings

* The new **SetBatchSettings** function fully replaces the previous SetBatchSetting method. It offers a clearer and more flexible way to configure multiple settings in a single call.
* Instead of individual parameters, SetBatchSettings now accepts a structured list in the request body, enabling multiple configuration values to be passed efficiently in one step.
* This function simplifies the application of settings for business use cases and ensures more consistent usage across the API.

</details>

<details>

<summary> <mark style="color:$info;">May 2025</mark> | Call Lookup &#x26; flexible batch processing &#x26; Auth Key</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="dTl38IFzsg9m">Call Lookup, </span><span data-option="UgeuWW250feg">Search &#x26; Autocomplete, </span><span data-option="vd8atzWlB99a">Validate &#x26; Update, </span><span data-option="aZKMlh4qtgFg">Enrich</span></td></tr></tbody></table>

API version 1.1 introduces a new module (Call Lookup) along with enhanced features for address processing, security, and configurability.

#### Call Lookup (Reverse Phone Search)

New lookup functionality enabling targeted reverse searches based on phone numbers.

#### Address Processing: SetBatchSetting with Type “99 - Dictionary”

Introduction of a new setting type that allows flexible configurations using JSON format.\
Typical use cases: triggering webhooks (e.g., Airflow), selectively excluding specific data sources, etc.

#### Address Processing: AddRecords

New endpoint for adding records to existing batches via HTTP PUT.\
Requirement: The batch must be in created status.\
This method complements the previous file-based import with an API-based alternative.

#### Personal Access Tokens (PAT)

Introduction of a new authentication method using PATs, which can be generated and managed through the portal. They provide an alternative to the traditional Bearer Token model.

**Usage:**\
Instead of Authorization: Bearer, the token is now transmitted in the header using auth-key.

</details>

<details>

<summary> <mark style="color:$info;">Jan 2025</mark> | Launch</summary>

<table><thead><tr><th>Modules in this release<select multiple><option value="dTl38IFzsg9m" label="Call Lookup" color="blue"></option><option value="UgeuWW250feg" label="Search &#x26; Autocomplete" color="blue"></option><option value="vd8atzWlB99a" label="Validate &#x26; Update" color="blue"></option><option value="aZKMlh4qtgFg" label="Enrich" color="blue"></option><option value="C1kP62OEyxQq" label="Hub" color="blue"></option></select></th></tr></thead><tbody><tr><td><span data-option="UgeuWW250feg">Search &#x26; Autocomplete, </span><span data-option="vd8atzWlB99a">Validate &#x26; Update, </span><span data-option="aZKMlh4qtgFg">Enrich</span></td></tr></tbody></table>

The first version of the multisource•api lays the foundation for the automated maintenance, enrichment, and search of address and personal data based on reliable Swiss sources.

#### Authentication

* Secure access to the API via Bearer Token.

#### Validate & Update

* Real-time validation and correction of addresses directly from operational systems (e.g., CRM, campaign management).
* Detection of address changes, deaths, relocations, duplicates, and incorrect address components.
* Use of multiple sources (relocation data, directories, building register) to ensure maximum data quality.

#### Enrich

* Enrichment of existing records with structured additional information.

#### Search & Autocomplete

* Intelligent search for individuals or companies based on partial information.
* Autocomplete for addresses – ideal for form fields (Web, App, CRM).

#### Batch Processing

* Processing of large data volumes via a high-performance processing engine.

#### Data Hosting & Privacy

* All data is processed exclusively in Switzerland – compliant with Swiss data protection regulations (DSG).

</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-integration-api/more/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.