Überprüfung der Handynummer Advanced

Advanced Handynummer-Überprüfung ist ein HLR Lookup-Dienst (Home Location Register) und eine Risikoprüfung, die es ermöglicht, die Gültigkeit einer Mobilnummer zu überprüfen sowie weitere spezifische Informationen wie den Leitungsstatus (z. B. getrennt, Telefon ausgeschaltet), Betrugsscore, Inhaber, Nutzungshäufigkeit für Online-Aktivitäten und zugehörige geografische Daten abzurufen.

Openapi bietet auch den Dienst Start an, der für diejenigen gedacht ist, die nur auf eine begrenzte Anzahl von Informationen zugreifen müssen (Nummerngültigkeit, aktueller und vorheriger Betreiber, geografische Informationen).

Der Dienst ist weltweit verfügbar und in wenigen Sekunden nutzbar.

Abfrage von Mobilnummer-Informationen

BEISPIELANFRAGE

POST /mobile-advanced

Um den Dienst zu nutzen, muss lediglich eine POST-Anfrage an den Endpunkt /mobile-advanced gestellt werden, wobei die zu überprüfende Mobilnummer als Parameter übergeben wird. Die Nummer muss immer mit der internationalen Vorwahl beginnen (z. B. +49) und darf keine Leerzeichen enthalten.

POST /mobile-advanced/+393391234567

Die Antwort dauert in der Regel nur wenige Sekunden. Wenn Sie jedoch benachrichtigt werden möchten, sobald alle Daten verfügbar sind, können Sie eine Callback-URL einrichten.

{
  "callback": {
    "url": "https://your-server.site/123232",
    "custom": 123
  }
}

HINWEIS: Beim Konfigurieren des Callbacks ist es obligatorisch, eine gültige URL anzugeben, die POST-Anfragen verarbeiten kann. Zusätzlich kann das Feld 'custom' mit beliebigen Zusatzdaten befüllt werden, die Sie in der Callback-Antwort erhalten möchten.

BEISPIELANTWORT

POST /mobile-advanced

Die Antwort enthält über 25 Informationen zur Mobilnummer, darunter:

"data": {
        "requestedNumber": "+393391234567",
        "formattedNumber": "+393391234567",
        "createdAt": "2025-07-29T12:13:25+00:00",
        "updatedAt": "2025-07-29T12:13:25+00:00",
        "state": "DONE",
        "message": "Phone is valid.",
        "success": true,
        "valid": true,
        "active": true,
        "local_format": "339 123 4567",
        "fraud_score": 0,
        "recent_abuse": false,
        "voip": "-",
        "prepaid": false,
        "risky": false,
        "name": "N/A",
        "identity_data": "-",
        "carrier": "VODAFONE",
        "line_type": "Wireless",
        "country": "IT",
        "region": "N/A",
        "city": "Rome",
        "accurate_country_code": false,
        "zip_code": "N/A",
        "timezone": "Europe/Rome",
        "dialing_code": 39,
        "do_not_call": false,
        "leaked": false,
        "spammer": false,
        "active_status": "N/A",
        "mcc": "222",
        "mnc": "10",
        "transaction_details": [],
        "errors": [],
        "id": "6888bae43eb5c5964009f930"
    }

HINWEIS: Wenn die Antwort "N/A" lautet (not available), bedeutet dies, dass die Information für diese Anfrage nicht verfügbar ist.

Falls die Antwort nicht innerhalb der ersten 10 Sekunden geliefert werden kann, wird eine Teilantwort mit Status NEW und der ID für eine asynchrone Verarbeitung zurückgegeben. Die Teildaten umfassen die analysierte und formatierte Nummer, den Zeitpunkt der Erstellung und Aktualisierung der Anfrage sowie die mit dieser Anfrage verbundene ID.

"data": {
        "requestedNumber":  "+393334567890",
        "formattedNumber":  "+393334567890",
        "createdAt":  "2025-07-24T15:20:42+00:00",
        "updatedAt":  "2025-07-24T15:20:44+00:00",
        "state":  "NEW",
        "message":  "",
        "id":  "68824f4a933ef7b3a5017d39"
    }

In diesem Fall ist ein zweiter (kostenfreier) Aufruf erforderlich, um die vollständigen Daten zu erhalten.

Mobilnummer-Details abrufen

Über den Endpoint GET /mobile-advanced können die mit dem POST-Aufruf bereitgestellten Daten einfach durch Angabe der ID abgerufen werden.

BEISPIELANFRAGE

GET /mobile-advanced

Der Endpoint zur Überprüfung des Anfragestatus lautet /mobile-advanced und verwendet die Methode GET. Wenn ein Callback implementiert wurde, werden Sie benachrichtigt, sobald Ihre Anfrage bearbeitet wurde und die Daten verfügbar sind.

Dies ist ein Beispiel für eine Anfrage mit der ID aus dem vorherigen POST-Aufruf:

GET/mobile-advanced/77e9e92216065fa37f3c9842

Die Antwort liefert die zuvor genannten Daten, die auch über die POST-Anfrage zugänglich sind.

Der Dienst "Erweiterte Mobilnummernprüfung" ist besonders nützlich für Finanzdienstleister, Banken, Versicherungen, E-Commerce-Plattformen, Marktplätze, Telekommunikationsanbieter sowie Unternehmen mit Abonnement- oder digitalen Diensten, da er es ermöglicht:

Dank der schnellen Rückmeldung und der umfassenden bereitgestellten Informationen ist dieser Dienst ein strategisches Werkzeug für alle Unternehmen, die auf Datenqualität, Prozesssicherheit und operative Effizienz setzen.