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.

Noch nicht freigeschaltete Agenten können auschließlich die Fähigkeiten der hinterlegten Testnummern abfragen.

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

Feature	Beschreibung
`FEATURE_UNSPECIFIED`	Nicht angegeben.
`REVOCATION`	Wenn dieses Feature unterstützt wird, können Sie eine gesendete Nachricht widerrufen, bevor sie zustellt wurde.
`RICHCARD_STANDALONE`	Eigenständige Rich Cards
`RICHCARD_CAROUSEL`	Karussell der Rich Cards
`ACTION_CREATE_CALENDAR_EVENT`	Die vorgeschlagene Aktion zum Erstellen eines Kalendertermins.
`ACTION_DIAL`	Vorgeschlagene Aktion zum Wählen einer Nummer.
`ACTION_OPEN_URL`	Die vorgeschlagene Aktion zum Öffnen einer URL.
`ACTION_SHARE_LOCATION`	Vorgeschlagene Aktion zum Teilen des Standorts.
`ACTION_VIEW_LOCATION`	Vorgeschlagene 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.

Es kann vorkommen, dass die Roaming-Abfrage “Kein Roaming” ergibt, obwohl die Nummer sich im Roaming befindet. Dies bedeutet in der Regel, dass Home Routing beim Netzbetreiber aktiviert wurde. Home Routing sorgt dafür, dass das Netz die Nummer als zu Hause meldet, unabhängig davon, wo sie sich gerade befindet.

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"
}