Gateway

  2. Home
  4. Gateway
  6. HTTP API
  8. CNAM Lookup

CNAM Lookup

Per CNAM Lookup können Sie den Caller ID Namen zu beliebigen Rufnummern weltweit abfragen. Bitte beachten Sie, dass nicht zu jeder Rufnummer ein Eintrag hinterlegt ist. Da die Daten aus verschiedensten Quellen zusammengetragen werden, sind hier teils geographische Standorte, Firmennamen/Namen oder der Netzbetreiber hinterlegt.

Richten Sie Ihre Abfragen bitte an folgende Adresse
https://gateway.sms77.io/api/lookup

Benötigte Parameter

Zusätzlich zu den Daten zur Authentifizierung werden folgende Parameter benötigt:
Parameter Beschreibung Beispiele
type CNAM Abfrage cnam
number Abzufragende Mobilfunknummer 491761234567890
0176-1234567890
00491761234567890

Rückgabe

Sie erhalten die Daten als JSON formatiert zurück. Bei ungültiger Nummer erhalten Sie ansonsten den Fehlercode 202, bei einem sonstigen Fehler bei der Abfrage den Code 600.

Rückgabe Beschreibung Mögliche Werte
success Abfrage erfolgreich true
false
code Rückgabecode 100 – Abfrage erfolgreich
202 – Nummer ungültig
500 – Nicht genug Guthaben
600 – Unbekannter Fehler
number E.164 formatierte Rufnummer +4915126716517
name Caller ID Name. Maximal 15 Zeichen ...

Beispiel

Anfrage:
https://gateway.sms77.io/api/lookup?p=api-key&type=cnam&number=4915126716517

Antwort:

{
    "code": "100",
    "name": "TELEKOM SMS",
    "number": "+4915126716517",
    "success": "true"
}