Lookup

Mit diesem Endpunkt können Sie Rufnummern formatieren und überprüfen. Überprüfen Sie eine Rufnummer auf Validität, zu welchen Mobilfunknetz eine Rufnummer gehört, formatieren Sie eine Rufnummer im nationalen und internationalen Format oder prüfen Sie, ob eine Rufnummer existiert und ins mobile Netz eingebucht ist.

Parameter

Alle unten genannten Abfragen benötigen lediglich die Rufnummer als Parameter:

  • Name
    number
    Type
    string
    Description

    Die abzufragende Nummer. Mehrere Nummern müssen per Komma getrennt werden. Das Format ist nahezu beliebig – unsere API formatiert die Nummer automatisch korrekt.


GET/api/lookup/format

Format

Fragen Sie das nationale und internationale Format beliebiger Mobilrufnummern ab. Zusätzlich erhalten Sie als Information den zugehörigen Netzbetreiber zu der Rufnummer (ohne Portierungsinformationen).

Anfrage

GET
/api/lookup/format
curl "https://gateway.seven.io/api/lookup/format?number=4917612345678" \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json"

Antwort

{
    "success": true,
    "national": "0176 12345678",
    "international": "+4917612345678",
    "international_formatted": "+49 176 12345678",
    "country_name": "Germany",
    "country_code": "49",
    "country_iso": "DE",
    "carrier": "O2",
    "network_type": "mobile"
}

GET/api/lookup/rcs

RCS Fähigkeiten

Über diesen Endpunkt können Sie die RCS Fähigkeit einer Rufnummer abfragen. Vor Versand einer RCS sollten Sie zunächst immer die Fähigkeiten einer Rufnummer abfragen und das Ergebnis gegebenenfalls zwischenspeichern.

Optionale Parameter

  • Name
    from
    Type
    string
    Description

    Zur Überprüfung der RCS Fähigkeiten einer Rufnummer wird stets die jeweilige Kennung des Agenten benötigt. Standardmäßig verwendet unsere API die erste RCS Absenderkennung in Ihrem Account. Mit diesem Parameter können Sie einen anderen Agenten nutzen.

Anfrage

GET
/api/lookup/rcs
curl "https://gateway.seven.io/api/lookup/rcs?number=4917612345678" \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json"

Antwort

{
  "success": true,
  "national": "0176 12345679",
  "international": "+49176123456789",
  "international_formatted": "+49 179 123456789",
  "country_name": "Germany",
  "country_code": "49",
  "country_iso": "DE",
  "carrier": "O2",
  "network_type": "mobile",
  "rcs_capabilities": [
    "RICHCARD_STANDALONE",
    "ACTION_CREATE_CALENDAR_EVENT",
    "ACTION_DIAL",
    "ACTION_OPEN_URL",
    "ACTION_SHARE_LOCATION",
    "ACTION_VIEW_LOCATION",
    "RICHCARD_CAROUSEL"
  ]
}

Übersicht aller Fähigkeiten

FeatureBeschreibung
FEATURE_UNSPECIFIEDNicht angegeben.
REVOCATIONWenn dieses Feature unterstützt wird, können Sie eine gesendete Nachricht widerrufen, bevor sie zustellt wurde.
RICHCARD_STANDALONEEigenständige Rich Cards
RICHCARD_CAROUSELKarussell der Rich Cards
ACTION_CREATE_CALENDAR_EVENTDie vorgeschlagene Aktion zum Erstellen eines Kalendertermins.
ACTION_DIALVorgeschlagene Aktion zum Wählen einer Nummer.
ACTION_OPEN_URLDie vorgeschlagene Aktion zum Öffnen einer URL.
ACTION_SHARE_LOCATIONVorgeschlagene Aktion zum Teilen des Standorts.
ACTION_VIEW_LOCATIONVorgeschlagene Aktion zum Ansehen eines Standorts in einer Karten-App.

GET/api/lookup/hlr

HLR

Erhalten Sie über eine Abfrage in der HLR Datenbank ausführliche Informationen zu einer Mobilfunknummer. Die Abfrage ist für Nummern aus fast allen Ländern/Netzen weltweit möglich.

Anfrage

GET
/api/lookup/hlr
curl "https://gateway.seven.io/api/lookup/hlr?number=4917612345678" \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json"

Antwort

{
    "status": true,
    "status_message": "success",
    "lookup_outcome": true,
    "lookup_outcome_message": "success",
    "international_format_number": "4917612345678",
    "international_formatted": "+49 176 12345678",
    "national_format_number": "0176 12345678",
    "country_code": "DE",
    "country_name": "Germany",
    "country_prefix": "49",
    "current_carrier":
    {
        "network_code": "26207",
        "name": "Telefonica Germany GmbH & Co. OHG",
        "country": "DE",
        "network_type": "mobile"
    },
    "original_carrier":
    {
        "network_code": "26207",
        "name": "Telefonica Germany GmbH & Co. OHG",
        "country": "DE",
        "network_type": "mobile"
    },
    "valid_number": "valid",
    "reachable": "unknown",
    "ported": "assumed_not_ported",
    "roaming": "not_roaming",
    "gsm_code": null,
    "gsm_message": null
}

GET/api/lookup/mnp

MNP

Fragen Sie über unsere MNP (Mobile Number Ported) API den Netzbetreiber einer beliebigen, internationalen Rufnummer ab.

Anfrage

GET
/api/lookup/mnp
curl "https://gateway.seven.io/api/lookup/mnp?number=4917612345678" \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json"

Antwort

{
    "success": true,
    "code": 100,
    "price": 0.005,
    "mnp":
    {
        "country": "DE",
        "number": "+4917612345678",
        "national_format": "0176 12345678",
        "international_formatted": "+49 176 12345678",
        "network": "Telekom Deutschland GmbH",
        "mccmnc": "26201",
        "isPorted": true,
        "network_type": "mobile"
    }
} %

GET/api/lookup/cnam

CNAM

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.

Anfrage

GET
/api/lookup/cnam
curl "https://gateway.seven.io/api/lookup/cnam?number=4917612345678" \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json"

Antwort

{
	"success": "true",
	"code": "100",
	"number": "4917612345678",
	"name": "GERMANY"
}
Zuletzt aktualisiert: Vor 5 Monaten