Verifica Numero Cellulare (HLR Lookup)

  • Openapi Evasione : Immediata
  • Openapi a partire da € 0,05 + iva

Verifica la validità di un numero di cellulare in pochi secondi, a livello globale.

Il servizio consente di accedere a oltre 15 informazioni dettagliate per convalidare numeri di cellulare, garantendo che il vostro database contenga solo contatti di alta qualità per le vostre comunicazioni.

Esempio Verifica Numero Cellulare (HLR Lookup)

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.

Le nostre tariffe

Listino prezzi a chiamata