Verifica Numero di Cellulare è un servizio di HLR Lookup (Home Location Register) e permette di controllare l’esistenza di un numero di cellulare ed ottenere informazioni come ad esempio l’operatore di telecomunicazione a cui è associato.

Il servizio effettua una prima ricerca e un controllo HLR (Home Location Register) sulla rete mobile, identifica i formati dei numeri di cellulare e poi arricchisce le informazioni come ad esempio su stato della SIM (attiva, bloccata, sospesa) ed eventuale cambio operatore.

Il servizio è disponibile in 56 paesi e con più di 260 operatori.

ESEMPIO RICHIESTA
POST /mobile-start/{mobile-phone-number}

Per utilizzare il servizio è necessario semplicemente effettuare una richiesta POST all’endpoint /mobile-start/{mobile-phone-number} passando come parametro il numero di cellulare che si vuole verificare. Il numero deve essere sempre preceduto da prefisso internazionale (es. +39).

POST /mobile-start/+393331234567

In fase di richiesta è possibile e consigliamo sempre di impostare una callback per ricevere una notifica quando la risposta è disponibile.

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

ESEMPIO RISPOSTA
POST /mobile-start/{mobile-phone-number}

La risposta viene restituita in media in pochi secondi ed include informazioni quali:

• validità numero di cellulare
• codice Paese
• Paese
• validità numero rispetto a Paese
• tipo di numero (nel nostro caso sarà sempre mobile)
• numero inserito
• numero formattato
• data e orario richiesta
• data aggiornamento
• stato richiesta ( NEW, WAIT, DONE)
• operatore originario
• operatore attuale
• roaming
• ported (cioè cambiamento di operatore con stesso numero)
• prefisso Paese numero cellulare
• dettaglio
• id richiesta

{
  "data": {
    "isPossible": true,
    "isValid": true,
    "regionCode": "IT",
    "isValidNumberForRegion": true,
    "numberType": "MOBILE",
    "requestedNumber": "00393332114474",
    "formattedNumber": "+393332114474",
    "createdAt": "2024-09-06T13:56:19+00:00",
    "updatedAt": "2024-09-06T13:56:19+00:00",
    "state": "DONE",
    "network": "MNO - Vodafone Italy",
    "originalNetwork": "MNO - TIM (Telecom Italia SpA)",
    "roaming": false,
    "ported": true,
    "country": "Italy",
    "countryPrefix": "39",
    "details": "DELIVERED_TO_HANDSET",
    "id": "66db0a03e8ba8710290e3c0f"
  },
  "success": true,
  "message": "",
  "error": null
}

Nel caso non fosse possibile gestirla entro i primi 10 secondi, verrà restituita una risposta parziale, con stato NEW e l’id per gestire la richiesta in modalità asincrona.

{
  "data": {
    "isPossible": true,
    "isValid": true,
    "regionCode": "IT",
    "isValidNumberForRegion": true,
    "numberType": "MOBILE",
    "requestedNumber": "00393332114474",
    "formattedNumber": "+393332114474",
    "createdAt": "2024-09-06T13:56:19+00:00",
    "updatedAt": "2024-09-06T13:56:19+00:00",
    "state": "NEW",
    "network": "",
    "originalNetwork": "",
    "roaming":,
    "ported":,
    "country": "",
    "countryPrefix": "",
    "details": "",
    "id": "66db0a03e8ba8710290e3c0f"
  },
  "success": true,
  "message": "",
  "error": null
}

In questo caso sarà necessario effettuare una seconda chiamata per ottenere i dati richiesti.

ESEMPIO RICHIESTA
GET /mobile-start/{id}

L’endpoint per verificare lo stato della richiesta è /mobile-start/{id} ed il metodo utilizzato è GET. In caso di implementazione della callback sarete avvertiti quando la vostra richiesta sarà evasa ed i vostri disponibili.

Questo è un esempio di richiesta con l’id ottenuto nella precedente chiamata POST

GET  /mobile-start/66db0a03e8ba8710290e3c0f. 

La risposta nel caso in cui è DONE, cioè evaso restituirà i dati indicati già precedentemente nella risposta alle richiesta in POST.

Verifica numero di cellulare è uno strumento fondamentale per tutte quelle aziende che si occupano di inviare comunicazioni tramite SMS o per quelle tech company che sviluppano soluzioni con questa funzionalità come ad esempio piattaforme SMS, CRM, Ecommerce.

Infatti il servizio consente di validare numeri esistenti e ripulire database da contatti non più attivi ottimizzando l'efficacia delle campagne e delle comunicazioni ad un costo veramente competitivo.