Vérification de Numéro de Mobile via API (HLR Lookup)

La vérification de numéro de mobile est un service de recherche HLR (Home Location Register) qui permet de vérifier l’existence d’un numéro de téléphone mobile et d’obtenir des informations telles que l’opérateur télécom auquel il est associé.

Le service effectue une première recherche et vérification HLR sur le réseau mobile, identifie les formats des numéros mobiles, puis enrichit les informations, telles que le statut de la SIM (active, bloquée, suspendue) et tout changement d’opérateur.

Le service est disponible dans 56 pays et avec plus de 260 opérateurs.

EXEMPLE DE REQUÊTE

POST /mobile-start/{numéro-de-téléphone-mobile}

Pour utiliser le service, il suffit d’envoyer une requête POST à l’endpoint /mobile-start/{numéro-de-téléphone-mobile}, en passant le numéro mobile à vérifier comme paramètre. Le numéro doit toujours être précédé par l’indicatif international (par exemple, +33).

POST /mobile-start/+33612345678

Lors de la requête, il est possible et toujours recommandé de définir un callback pour recevoir une notification lorsque la réponse est disponible.

{
  "callback": {
    "url": "https://votre-serveur.site/123232",
    "custom": 123
  }
}

EXEMPLE DE RÉPONSE

POST /mobile-start/{numéro-de-téléphone-mobile}

La réponse est généralement renvoyée en quelques secondes et inclut des informations telles que :

{
  "data": {
    "isPossible": true,
    "isValid": true,
    "regionCode": "FR",
    "isValidNumberForRegion": true,
    "numberType": "MOBILE",
    "requestedNumber": "0033612345678",
    "formattedNumber": "+33612345678",
    "createdAt": "2024-09-06T13:56:19+00:00",
    "updatedAt": "2024-09-06T13:56:19+00:00",
    "state": "DONE",
    "network": "MNO - Orange France",
    "originalNetwork": "MNO - Bouygues Telecom",
    "roaming": false,
    "ported": true,
    "country": "France",
    "countryPrefix": "33",
    "details": "DELIVERED_TO_HANDSET",
    "id": "66db0a03e8ba8710290e3c0f"
  },
  "success": true,
  "message": "",
  "error": null
}

Si le traitement n’est pas possible dans les 10 premières secondes, une réponse partielle sera renvoyée avec le statut NEW et l'ID pour gérer la demande de manière asynchrone.

{
  "data": {
    "isPossible": true,
    "isValid": true,
    "regionCode": "FR",
    "isValidNumberForRegion": true,
    "numberType": "MOBILE",
    "requestedNumber": "0033612345678",
    "formattedNumber": "+33612345678",
    "createdAt": "2024-09-06T13:56:19+00:00",
    "updatedAt": "2024-09-06T13:56:19+00:00",
    "state": "NEW",
    "network": "Bouygues Telecom",
    "originalNetwork": "Orange France",
    "roaming": false,
    "ported": true,
    "country": "France",
    "countryPrefix": 33,
    "details": "DELIVERED_TO_HANDSET",
    "id": "66db0a03e8ba8710290e3c0f"
  },
  "success": true,
  "message": "",
  "error": null
}

Dans ce cas, il sera nécessaire de faire un second appel pour obtenir les données requises.

EXEMPLE DE REQUÊTE

GET /mobile-start/{id}

L’endpoint pour vérifier le statut de la demande est /mobile-start/{id}, et la méthode utilisée est GET. Si un callback est implémenté, vous serez informé lorsque votre demande sera traitée et vos données disponibles.

Ceci est un exemple de requête avec l’ID obtenu dans l'appel POST précédent.

GET /mobile-start/66db0a03e8ba8710290e3c0f

La réponse, si le statut est DONE, renverra les mêmes données que celles indiquées dans la réponse POST précédente.

La vérification du numéro mobile est un outil essentiel pour toutes les entreprises qui envoient des communications par SMS ou les entreprises technologiques qui développent des solutions avec cette fonctionnalité, telles que les plateformes SMS, les CRM et les sites e-commerce.

En effet, ce service permet de valider les numéros existants et de nettoyer les bases de données des contacts inactifs, optimisant ainsi l’efficacité des campagnes et communications à un coût très compétitif.