Vérification de Numéro de Mobile Avancée

Vérification Numéro de Téléphone Mobile Avancée est un service de HLR Lookup (Home Location Register) et d’analyse de risque qui permet de vérifier la validité d’un numéro de téléphone mobile et d’obtenir d’autres informations spécifiques comme l’état de la ligne (ex. déconnectée, téléphone éteint), le score de fraude, le titulaire, l'exposition récente à une violation de données et les données géographiques associées.

Openapi propose également le service Start, conçu pour ceux qui ont besoin d’accéder à un nombre plus limité d’informations (validité du numéro, opérateur actuel et précédent, données géographiques).

Le service est disponible dans le monde entier et en quelques secondes.

Requête d’information sur un Numéro Mobile

EXEMPLE DE REQUÊTE

POST /mobile-advanced

Pour utiliser le service, il suffit d’effectuer une requête POST vers l’endpoint /mobile-advanced en passant en paramètre le numéro de téléphone mobile à vérifier. Le numéro doit toujours être précédé de l’indicatif international (ex. +33) et ne doit pas contenir d’espaces entre les chiffres.

POST /mobile-advanced/+3391234567

La réponse prend généralement quelques secondes, mais si vous souhaitez être notifié lorsque toutes les données sont disponibles, vous pouvez configurer un callback.

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

REMARQUE : Lors de la configuration du callback, il est obligatoire de fournir une URL valide, capable de gérer les requêtes POST. Il est également possible de remplir le champ 'custom' avec toute donnée supplémentaire à inclure dans la réponse du callback.

EXEMPLE DE RÉPONSE

POST /mobile-advanced

La réponse comprend plus de 25 informations sur le numéro de téléphone mobile, parmi lesquelles :

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

REMARQUE: Lorsque la réponse est "N/A" (non disponible), cela signifie que l’information n’est pas accessible pour cette requête.

Si le traitement prend plus de 10 secondes, une réponse partielle est retournée avec l’état NEW et un id pour permettre un traitement asynchrone. Les données partielles comprennent le numéro analysé et formaté, l'heure de création et de mise à jour de la requête, ainsi que l'identifiant associé à cette requête.

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

Dans ce cas, une seconde requête (gratuite) sera nécessaire pour obtenir les données complètes.

Récupérer les détails d’un Numéro Mobile

Via l’endpoint GET /mobile-advanced, vous pouvez récupérer les données générées par la requête POST, en fournissant simplement l’id.

EXEMPLE DE REQUÊTE

GET /mobile-advanced

L’endpoint pour vérifier l’état de la requête est /mobile-advanced, méthode GET. En cas d’implémentation d’un callback, vous serez notifié lorsque les données seront prêtes.

Voici un exemple de requête avec l’id obtenu lors de l’appel POST :

GET/mobile-advanced/77e9e92216065fa37f3c9842

La réponse fournit les mêmes données que celles obtenues via la requête POST.

Le service Vérification Numéro de Mobile Avancée est utile pour les services financiers, banques, assurances, plateformes e-commerce, marketplaces, opérateurs télécom et toute entreprise proposant des abonnements ou services numériques, car il permet de :

Grâce à la rapidité de la réponse et à la richesse des données fournies, ce service représente un outil stratégique pour toutes les organisations qui misent sur la qualité des données, la sécurité des processus et l’efficacité opérationnelle.