Call Lookup

Call Lookup ermittelt basierend auf einer Telefonnummer die dazugehörigen öffentlich publizierten Angaben (Name, Adresse etc.). Dies ist besonders nützlich für die Erkennung eingehender Anrufe in Systemen wie:

• Telefonieanlagen

• CRMs

• Helpdesk-Systemen

Authentifizierung mit API-Key

Für den Zugriff auf die API wird ein API-Key benötigt.

1

API-Key erhalten

Der API-Key wird nach erfolgreichem Onboarding von uns bereitgestellt.

2

API-Key im Request verwenden

Der API-Key muss bei jedem Request im Header übermittelt werden.

Beispiel:

curl --location 'https://api.multisource.ch/v2/search/calllookup?number=[phone]' \
--header 'Auth-Key: <API-KEY>'

API-Endpoint

get

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

/Search/CallLookup

Autorisierungen

auth-key

auth-keystringErforderlich

API Key required for authorized endpoints

Abfrageparameter

numberstringOptional

outputFormatintegerOptionalDefault: 1

Antworten

200

OK

text/plainapplication/jsontext/json

hitCountinteger · int32Optional

resultCountinteger · int32Optional

get

/Search/CallLookup

HTTPcURLJavaScriptPython

GET /v2/Search/CallLookup HTTP/1.1
Host: api.multisource.ch
auth-key: YOUR_API_KEY
Accept: */*

200

OK

{
  "hitCount": 1,
  "resultCount": 1,
  "data": [
    {
      "dwhId": "text",
      "companyname": "text",
      "firstname": "text",
      "name": "text",
      "street": "text",
      "houseNumber": "text",
      "zip": "text",
      "location": "text",
      "phoneNumbers": [
        "text"
      ],
      "mobileNumbers": [
        "text"
      ]
    }
  ]
}

Parameter

Parameter	Typ	Beschreibung	Beispiel
number	string	Die Telefonnummer im lokalen Format (ohne Ländervorwahl) oder im E.164-Format (mit +)	0791234567 [phone]
outputFormat	integer	Format der zurückgegebenen Telefonnummer: 1 = Lokales Format (ohne Ländervorwahl) 2 = E.164 (mit + und Ländervorwahl)	1 = 0791234567 2 = [phone]

Response Felder

Root-Level Felder

Feld	Typ	Beschreibung	Beispiel
hitCount	integer	Gesamtanzahl der Treffer in der Datenbank für die angefragte Telefonnummer	1
resultCount	integer	Anzahl der tatsächlich zurückgegebenen Einträge im data-Array	1
data	array	Array mit den gefundenen Verzeichniseinträgen	siehe Eintragsfelder unten

Eintrags-Felder

Feld	Typ	Beschreibung	Beispiel
dwhId	string	Eindeutige ID des Eintrags	ABC123456789
companyname	string	Firmenname bei Unternehmenseinträgen	Swisscom Directories AG
firstname	string	Vorname bei Privatpersonen	Lara
name	string	Nachname bei Privatpersonen	Graf
street	string	Strassenname	Förrlibuckstrasse
houseNumber	string	Hausnummer	62
zip	string	Postleitzahl (PLZ)	8005
location	string	Ortsname	Zürich
phoneNumbers	array	Array mit einer oder mehreren Festnetznummern	[ “[phone]", "[phone]" ]
mobileNumbers	array	Array mit einer oder mehreren Mobilnummern	[ “[phone]" ]

Voraussetzungen für erfolgreiche Ergebnisse

Die angegebene Telefonnummer muss in unseren öffentlichen Verzeichnissen (local.ch oder search.ch) eingetragen und für die Rückwärtssuche freigegeben sein.

Hinweise

Telefonnummern als Arrays

• phoneNumbers und mobileNumbers sind immer Arrays, auch bei nur einer Nummer

• Leere Arrays [] bedeuten, dass keine Nummern dieser Art vorhanden sind

Umgang mit mehreren Einträgen

Eine Telefonnummer kann mehrere Einträge haben (z.B. mehrere Personen in einem Haushalt oder verschiedene Abteilungen einer Firma). Wenn mehrere Einträge zurückgegeben werden (resultCount > 1), empfehlen wir folgende Anzeigelogik für die Integration:

Option 1: Ersten Eintrag anzeigen

Der erste Eintrag im data-Array ist in der Regel der Haupteintrag und eignet sich für eine einfache Anzeige im Telefoniesystem.

Option 2: Alle Einträge anbieten

Bei erweiterten Integrationen können alle zurückgegebenen Einträge in einer Dropdown-Liste oder als Auswahlmöglichkeit angezeigt werden.

Beispiel: Output mit mehreren Einträgen

{
  "id": "123",
  "status": 200,
  "info": [],
  "result": {
    "hitCount": 2,
    "resultCount": 2,
    "data": [
      {
        "dwhId": "ABC1234567890",
        "companyname": "Swisscom Directories AG",
        "firstname": "",
        "name": "",
        "street": "Förrlibuckstrasse",
        "houseNumber": "62",
        "zip": "8005",
        "location": "Zürich",
        "phoneNumbers": [],
        "mobileNumbers": [
          "[phone]"
        ]
      },
      {
        "dwhId": "CBA0987654321",
        "companyname": "",
        "firstname": "Lara",
        "name": "Graf",
        "street": "Förrlibuckstrasse",
        "houseNumber": "62",
        "zip": "8005",
        "location": "Zürich",
        "phoneNumbers": [],
        "mobileNumbers": [
          "[phone]"
        ]
      }
    ]
  }
}