HLR · MNP · Type de numéro
HLR lookup : statut en direct de tout numéro mobile
Notre service de HLR lookup demande au réseau mobile si un numéro est actif, quel opérateur le dessert aujourd’hui, et s’il a été porté ou s’il est en roaming. Vérifiez un numéro ou 10 000 à la fois, dans le panel ou par API, et ne payez que les requêtes qui aboutissent.
- Seules les requêtes réussies sont facturées
- Sans abonnement ni minimum
- Crypto, carte ou PayPal
- Opérateur actuel
- SFR
- Opérateur d’origine
- Orange
- Porté
- Oui
- Roaming
- Non
- MCC / MNC
- 208 / 10
- Type de numéro
- Mobile
Le HLR lookup en bref
- Prix
- €0.0038par requête HLR · MNP dès €0.0030
- Facturation
- Au succèsUne requête qui échoue n’est jamais facturée. Sans abonnement ni minimum.
- En masse
- 10 000 numérospar lot, collés ou importés en CSV ou TXT
- Résultats
- Statut en directplus l’opérateur actuel et d’origine, la portabilité, le roaming et le MCC/MNC
- Accès
- Panel + API RESTclés API avec des droits de lecture et d’écriture séparés
- Exports
- JSON · CSV · XLSXdisponibles 30 jours après chaque lot
Définition
Qu’est-ce qu’un HLR lookup ?
Un HLR lookup, ou requête HLR, interroge en temps réel le HLR (Home Location Register), la base de données où un opérateur mobile suit chacun de ses abonnés. Il indique si un numéro est actif en ce moment, sur quel réseau il se trouve, s’il a été porté vers un autre opérateur et s’il est en roaming à l’étranger. Rien n’arrive sur le téléphone : ni appel ni SMS, le titulaire ne remarque pas la vérification.
Vous envoyez un numéro
Dans le panel, dans un fichier CSV ou par un appel API.
Bitcall achemine la requête
Vers le réseau d’origine du numéro.
Le HLR répond
Statut, réseau actuel, portabilité et roaming.
Vous recevez le résultat
À l’écran, dans votre export ou dans la réponse de l’API.
Pourquoi les entreprises utilisent le HLR lookup
Les entreprises lancent une requête HLR avant d’envoyer des SMS, de valider une inscription ou d’acheminer des appels. Elles évitent ainsi de payer des messages vers des numéros inactifs et envoient les numéros portés vers le réseau où ils se trouvent vraiment.
Ni appel, ni SMS, ni notification : la personne derrière le numéro ne sait jamais qu’il a été vérifié.
HLR ou VLR
HLR et VLR fonctionnent ensemble : quand un téléphone est en roaming, le HLR d’origine renvoie vers le VLR du réseau visité. C’est ainsi qu’une requête peut vous dire qu’un numéro est à l’étranger.
| HLR | VLR | |
|---|---|---|
Tenu par | L’opérateur d’origine de l’abonné | Le réseau que le téléphone utilise en ce moment |
Contient | Le profil de chaque abonné et le réseau où il est enregistré | Les téléphones présents dans sa zone |
Durée | Permanente | Temporaire, le temps que le téléphone y reste |
Ce que renvoie un HLR lookup
Chaque résultat arrive sous forme de données structurées, à filtrer, exporter ou intégrer à vos propres outils.
Statut de connexion
CONNECTED
Si le numéro est sur le réseau en ce moment, absent (éteint ou hors couverture) ou invalide.
Opérateur actuel
SFR
L’opérateur qui dessert le numéro aujourd’hui, après une éventuelle portabilité.
Opérateur d’origine
Orange
L’opérateur à qui la tranche de numéros a été attribuée au départ.
Porté
true
Si le numéro a changé d’opérateur, avec le nouveau réseau et le pays.
Roaming
false
Si le téléphone est à l’étranger, et sur quel réseau, dans quel pays.
MCC / MNC
208 / 10
Les codes pays et réseau mobile du réseau actuel, pour l’acheminement.
Pays
France · +33
Le nom du pays, son code ISO et l’indicatif du numéro.
Joignable
true
Un oui ou non tout prêt, déduit du statut, pour filtrer facilement.
Exemple de réponse API (abrégée)
{
"data": {
"status": "completed",
"price": {
"amount": 0.0038,
"currency": "EUR"
},
"result": {
"connectivityStatus": "CONNECTED",
"reachable": true,
"mccmnc": "20810",
"mcc": "208",
"mnc": "10",
"currentNetwork": "SFR",
"originalNetwork": "Orange",
"originalCountryName": "France",
"originalCountryCode": "FR",
"originalCountryPrefix": "33",
"ported": true,
"portedNetworkName": "SFR",
"roaming": false
}
}
}Valeurs du statut
- CONNECTED
- Enregistré sur le réseau et joignable maintenant.
- ABSENT
- Pas enregistré en ce moment : éteint, hors couverture ou inactif.
- INVALID_MSISDN
- Pas un numéro mobile valide et attribué.
- UNDETERMINED
- Le réseau n’a pas donné de réponse claire.
Tarifs du HLR lookup
Trois requêtes pour trois questions. Les prix s’entendent par numéro et ne sont facturés que si la requête aboutit.
Requête MNP
Sur quel réseau est ce numéro ?
dès€0.0030par requête
- Porté ou non
- Opérateur d’origine et actuel
- MCC/MNC du réseau actuel
- Date de portabilité quand l’opérateur la fournit
HLR lookup
Ce numéro est-il actif en ce moment ?
dès€0.0038par requête
- Actif, absent ou invalide
- Opérateur actuel et d’origine
- Portabilité et roaming
- MCC/MNC pour l’acheminement
Type de numéro
Mobile, fixe ou VoIP ?
dès€0.0038par requête
- Type de ligne : mobile, fixe, VoIP, numéro vert
- L’opérateur à qui appartient la tranche
- Pays et MCC/MNC
- Écartez les fixes avant d’envoyer des SMS
- Sans abonnement ni minimum
- Une requête qui échoue n’est jamais facturée
- Gros volumes ? Parler à notre équipe
- Testez d’abord : demandez €0.10 de crédit offert
HLR lookup en masse pour des listes entières
Nettoyez une base de numéros avant une campagne, en quelques clics.
- Collez les numéros ou importez un fichier CSV ou TXT, jusqu’à 10 000 numéros par lot
- Les numéros sont nettoyés et les doublons retirés automatiquement
- Suivez l’avancement en direct pendant le traitement
- Téléchargez les résultats en JSON, CSV ou XLSX ; les exports restent disponibles 30 jours
- Chaque lot reste dans votre historique
7 420 sur 10 000 vérifiés
- +33 6 39 98 12 34Actifs
- +33 6 39 98 14 56Absents
- +33 6 39 98 17 89Invalides
- Actifs
- 6,912
- Absents
- 388
- Invalides
- 120
[
{ "inputValue": "33639981234", "resultStatus": "success", "currentNetwork": "SFR", "reachable": true, … },
{ "inputValue": "33639981456", "resultStatus": "success", "currentNetwork": "Orange", "reachable": false, … },
{ "inputValue": "33639981789", "resultStatus": "success", "currentNetwork": "SFR", "reachable": false, … }
]inputValue,resultStatus,currentNetwork,reachable,… 33639981234,success,SFR,true,… 33639981456,success,Orange,false,… 33639981789,success,SFR,false,…
inputValue | resultStatus | currentNetwork | reachable | … |
|---|---|---|---|---|
33639981234 | success | SFR | true | … |
33639981456 | success | Orange | false | … |
33639981789 | success | SFR | false | … |
API de HLR lookup
Une requête vérifie un numéro. Une autre envoie un lot de 10 000 numéros au plus.
curl -X POST https://api.bitcall.io/v1/hlr/lookups \
-H "x-key-id: $BITCALL_KEY_ID" \
-H "x-api-secret: $BITCALL_API_SECRET" \
-H "Content-Type: application/json" \
-d '{"lookupType":"hlr-single","productCode":"hlr:V11","number":"33639981234"}'const res = await fetch('https://api.bitcall.io/v1/hlr/lookups', {
method: 'POST',
headers: {
'x-key-id': process.env.BITCALL_KEY_ID,
'x-api-secret': process.env.BITCALL_API_SECRET,
'Content-Type': 'application/json'
},
body: JSON.stringify({ lookupType: 'hlr-single', productCode: 'hlr:V11', number: '33639981234' })
})
const { data } = await res.json()
console.log(data.result.connectivityStatus, data.result.currentNetwork)import os, requests
res = requests.post(
"https://api.bitcall.io/v1/hlr/lookups",
headers={"x-key-id": os.environ["BITCALL_KEY_ID"], "x-api-secret": os.environ["BITCALL_API_SECRET"]},
json={"lookupType": "hlr-single", "productCode": "hlr:V11", "number": "33639981234"},
)
result = res.json()["data"]["result"]
print(result["connectivityStatus"], result["currentNetwork"])JOB_ID=$(curl -s -X POST https://api.bitcall.io/v1/hlr/lookups \
-H "x-key-id: $BITCALL_KEY_ID" \
-H "x-api-secret: $BITCALL_API_SECRET" \
-H "Content-Type: application/json" \
-d '{"lookupType":"hlr-batch","productCode":"hlr:V11","numbers":["33639981234","33639981456"]}' | jq -r '.data.jobId')
curl https://api.bitcall.io/v1/hlr/lookups/$JOB_ID/results \
-H "x-key-id: $BITCALL_KEY_ID" \
-H "x-api-secret: $BITCALL_API_SECRET"
curl -X POST https://api.bitcall.io/v1/hlr/lookups/$JOB_ID/exports \
-H "x-key-id: $BITCALL_KEY_ID" \
-H "x-api-secret: $BITCALL_API_SECRET" \
-H "Content-Type: application/json" \
-d '{"format":"csv"}'curl "https://api.bitcall.io/v1/hlr/lookups?page=1&pageSize=50" \
-H "x-key-id: $BITCALL_KEY_ID" \
-H "x-api-secret: $BITCALL_API_SECRET"{
"data": {
"status": "completed",
"price": {
"amount": 0.0038,
"currency": "EUR"
},
"result": {
"connectivityStatus": "CONNECTED",
"currentNetwork": "SFR"
}
}
}À quoi servent les requêtes HLR
La même requête répond à des questions différentes pour le marketing, la sécurité et l’acheminement.
Nettoyer une liste SMS avant une campagne
Retirez d’abord les numéros absents et invalides : chaque message payé part vers un téléphone qui peut le recevoir.
Bloquer les fausses inscriptions
Vérifiez le numéro à l’inscription et repérez ceux qui ne sont pas des mobiles actifs avant d’envoyer un code de vérification.
Acheminer correctement les numéros portés
Opérateurs et revendeurs utilisent le MCC/MNC et les données de portabilité pour envoyer appels et SMS vers le réseau où se trouve vraiment le numéro.
Voir le programme revendeurGarder un CRM à jour
Revérifiez régulièrement vos anciens contacts et marquez les numéros devenus inactifs ou qui ont changé d’opérateur.
Bitcall HLR lookup face aux autres
Les mêmes requêtes HLR, MNP et type de numéro, sans abonnement mensuel, avec paiement en crypto et rien de facturé pour une requête qui échoue.
| Bitcall | hlr-lookups.com | hlrlookup.com | NeutrinoAPI | Twilio Lookup | seven.io | Messente | |
|---|---|---|---|---|---|---|---|
Prix d’une requête HLR | Dès €0.0038 | €0.0100 | €0.0058 | €0.0061 | $0.0070 | €0.0100 | €0.002 + €199/mois |
Requêtes MNP | dès €0.0030 | Oui | Non indiqué sur leur site | Non indiqué sur leur site | Non indiqué sur leur site | Oui | Non indiqué sur leur site |
Requêtes type de numéro | €0.0038 | Oui | Non indiqué sur leur site | Non indiqué sur leur site | Oui | Non indiqué sur leur site | Non indiqué sur leur site |
Sans abonnement mensuel | Oui | Oui | Oui | Non indiqué sur leur site | Oui | Non indiqué sur leur site | ✕ Non |
Seules les requêtes réussies sont facturées | Échecs non facturés | Non indiqué sur leur site | Oui | Non indiqué sur leur site | Non indiqué sur leur site | Non indiqué sur leur site | Non indiqué sur leur site |
Paiement en crypto | BTC, USDT, ETH | Oui | Non indiqué sur leur site | ✕ Non | Non indiqué sur leur site | Oui | Non indiqué sur leur site |
Import en masse dans le panel | 10 000 par lot | Oui | Oui | Non indiqué sur leur site | Non indiqué sur leur site | Oui | Oui |
API REST | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
Exports JSON, CSV et XLSX | Oui | Non indiqué sur leur site | Non indiqué sur leur site | Non indiqué sur leur site | Non indiqué sur leur site | Non indiqué sur leur site | Non indiqué sur leur site |
FAQ sur le HLR lookup
Des réponses claires sur le fonctionnement et le prix des requêtes HLR.
Un HLR lookup, ou requête HLR, interroge en temps réel le Home Location Register d’un opérateur mobile, la base de données qui suit chaque abonné du réseau. Il indique si un numéro est actif, quel réseau le dessert, s’il a été porté et s’il est en roaming.
Oui. Les requêtes HLR sont un outil courant des plateformes SMS, des opérateurs et des équipes antifraude. Une requête renvoie des données réseau sur un numéro, comme son statut, son opérateur, sa portabilité et le roaming. Elle ne renvoie ni le nom ni l’adresse du titulaire.
Lancez un HLR lookup. CONNECTED veut dire que le numéro est en service et que le téléphone est enregistré sur le réseau en ce moment. ABSENT veut dire qu’il est éteint, hors couverture ou pas enregistré pour l’instant. INVALID_MSISDN veut dire que le numéro n’est pas attribué. Un numéro absent peut revenir : revérifiez-le avant de le supprimer.
Une requête HLR interroge le réseau en direct : statut, opérateur actuel, portabilité et roaming. Une requête MNP s’appuie sur les données de portabilité : elle indique sur quel réseau se trouve un numéro aujourd’hui, sans statut en direct, et coûte moins cher. Une requête type de numéro indique si un numéro est mobile, fixe, VoIP ou d’un autre type.
Un numéro porté a changé d’opérateur mobile en gardant ses chiffres, grâce à la portabilité : son préfixe ne dit donc plus sur quel réseau il se trouve. Une requête MNP, ou un HLR lookup qui inclut la portabilité, indique si le numéro a été porté, l’opérateur à qui il a été attribué au départ et celui sur lequel il se trouve aujourd’hui, avec le MCC/MNC de ce réseau.
Dès €0.0038 par numéro pour le HLR, €0.0030 pour le MNP et €0.0038 pour le type de numéro. Seules les requêtes réussies sont facturées, sur un solde prépayé, sans abonnement ni minimum. Des tarifs dégressifs sont possibles sur demande.
Non. Le montant est réservé à l’envoi puis libéré pour chaque numéro rejeté ou en échec : seules les requêtes réussies sont facturées. Annuler un lot avant son traitement libère aussi la réservation.
Oui. Collez les numéros ou importez un fichier CSV ou TXT dans le panel, jusqu’à 10 000 numéros par lot, ou envoyez-les en un seul appel API. Téléchargez les résultats en JSON, CSV ou XLSX.
Oui. L’API REST accepte un numéro seul ou un lot de 10 000 numéros au plus, avec des clés API aux droits de lecture et d’écriture séparés. La documentation de l’API HLR décrit chaque endpoint avec des exemples.
Lancez une requête type de numéro : elle indique si un numéro est mobile, fixe, VoIP, gratuit, surtaxé ou d’un autre type. Le HLR lookup, lui, ne fonctionne que pour les numéros mobiles, car seuls les réseaux mobiles ont un HLR.
Les numéros mobiles de pays du monde entier, États-Unis compris. La couverture dépend de chaque opérateur : quand un réseau ne répond pas aux requêtes HLR en direct, la réponse peut venir des données de portabilité.
Demandez à notre équipe €0.10 de crédit de test offert, soit environ 25 requêtes HLR, et essayez-le sur vos propres numéros. Ensuite, les requêtes HLR démarrent à €0.0038, sans abonnement. Pour savoir si un numéro est valide et de quel type il est, utilisez le vérificateur de numéro gratuit, gratuit et sans limite.
Non. Un HLR lookup reçoit sa réponse du réseau, pas du téléphone. Il n’y a ni appel, ni SMS, ni notification sur l’appareil.
Vérifiez votre prochaine liste avant de l’envoyer
Créez un compte gratuit, rechargez par carte, PayPal ou crypto, et lancez votre première requête en quelques minutes.