Data Input

The multisource•api can process incoming data in two ways – either directly via the API (AddRecords) or through a file upload.

AddRecords (API-based input)

Mapping and data import can be performed directly through the API.

put

https://api.multisource.ch/v2https://api.multisource.chhttps://apitep.multisource.ch

/addressprocessing/AddRecords

Authorizations

auth-key

auth-keystringRequired

API Key required for authorized endpoints

Query parameters

idinteger · int32Optional

uidstring · uuidOptional

Bodyobject[]

application/jsontext/jsonapplication/*+json

customerIdstring · nullableOptional

classificationstring · nullableOptional

dwhIdstring · nullableOptional

kbbCompanyIdinteger · int32 · nullableOptional

kbcPersonIdinteger · int32 · nullableOptional

kbcHouseholdIdinteger · int32 · nullableOptional

beacinteger · int32 · nullableOptional

egidstring · nullableOptional

edidstring · nullableOptional

postAddressIdstring · nullableOptional

freetext1string · nullableOptional

freetext2string · nullableOptional

freetext3string · nullableOptional

freetext4string · nullableOptional

freetext5string · nullableOptional

firstnamestring · nullableOptional

companyNamestring · nullableOptional

namestring · nullableOptional

birthDatestring · nullableOptional

streetstring · nullableOptional

streetNostring · nullableOptional

streetAddstring · nullableOptional

careOfstring · nullableOptional

poBoxstring · nullableOptional

poZipstring · nullableOptional

poTownstring · nullableOptional

zipstring · nullableOptional

townstring · nullableOptional

mobileNostring · nullableOptional

phoneNostring · nullableOptional

emailstring · nullableOptional

uidstring · nullableOptional

chnrstring · nullableOptional

Responses

200

OK

text/plainapplication/jsontext/json

stringOptional

put

/addressprocessing/AddRecords

HTTPcURLJavaScriptPython

PUT /v2/addressprocessing/AddRecords HTTP/1.1
Host: api.multisource.ch
auth-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 561

[
  {
    "customerId": "text",
    "classification": "text",
    "dwhId": "text",
    "kbbCompanyId": 1,
    "kbcPersonId": 1,
    "kbcHouseholdId": 1,
    "beac": 1,
    "egid": "text",
    "edid": "text",
    "postAddressId": "text",
    "freetext1": "text",
    "freetext2": "text",
    "freetext3": "text",
    "freetext4": "text",
    "freetext5": "text",
    "firstname": "text",
    "companyName": "text",
    "name": "text",
    "birthDate": "text",
    "street": "text",
    "streetNo": "text",
    "streetAdd": "text",
    "careOf": "text",
    "poBox": "text",
    "poZip": "text",
    "poTown": "text",
    "zip": "text",
    "town": "text",
    "mobileNo": "text",
    "phoneNo": "text",
    "email": "text",
    "uid": "text",
    "chnr": "text"
  }
]

application/jsontext/jsonapplication/*+json

200

OK

text

File upload

Customer data can be uploaded in any structured format such as TXT, CSV, TSV, or XLSX.

Two mapping options are available:

Standard mapping

The multisource•api provides a preconfigured standard mapping that covers the most common field names (name, first name, street, house number, postal code, city, etc.).

Custom mapping

Alternatively, a customer-specific mapping can be defined. This is created jointly during the onboarding process.

Multiple mappings can also be defined in parallel – for example, when data originates from different source systems with varying field structures.

The API can generally handle almost any structured data format.

For optimal matching, it is recommended to fill in at least the following fields: name, first name, street, house number, postal code, and city.

post

https://api.multisource.ch/v2https://api.multisource.chhttps://apitep.multisource.ch

/addressprocessing/FileUpload

Authorizations

auth-key

auth-keystringRequired

API Key required for authorized endpoints

Query parameters

batchIdinteger · int32Optional

batchUidstring · uuidOptional

descriptionstringOptional

Body

multipart/form-data

filestring · binaryOptional

Responses

200

OK

text/plainapplication/jsontext/json

stringOptional

post

/addressprocessing/FileUpload

HTTPcURLJavaScriptPython

POST /v2/addressprocessing/FileUpload HTTP/1.1
Host: api.multisource.ch
auth-key: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

200

OK

text