HLR · MNP · Тип номера
HLR-запрос: проверка номера на активность онлайн
Наш сервис HLR-запросов спрашивает у мобильной сети, в сети ли номер прямо сейчас, какой оператор его обслуживает, перенесён ли он и не в роуминге ли абонент. Проверяйте один номер или 10 000 сразу, в личном кабинете или через API, и платите только за успешные запросы.
- Оплата только за успешные запросы
- Без абонплаты и минимального платежа
- Криптовалюта, карта или PayPal
- Текущий оператор
- Vodafone UK
- Исходный оператор
- O2 UK
- Перенесён
- Да
- Роуминг
- Нет
- MCC / MNC
- 234 / 15
- Тип номера
- Мобильный
HLR-запрос коротко
- Цена
- €0.0038за HLR-запрос · MNP от €0.0030
- Оплата
- За результатНеудачные запросы не списываются. Без абонплаты и минимального платежа.
- Массово
- 10 000 номеровв пакете: вставьте списком или загрузите CSV или TXT
- Результат
- Статус в сетиа также текущий и исходный оператор, перенос, роуминг и MCC/MNC
- Доступ
- Кабинет + REST APIAPI-ключи с отдельными правами на чтение и запись
- Выгрузка
- JSON · CSV · XLSXдоступна 30 дней после каждого пакета
Определение
Что такое HLR-запрос?
HLR-запрос — это запрос в реальном времени к HLR (Home Location Register), базе данных, в которой мобильный оператор ведёт всех своих абонентов. Он показывает, в сети ли номер прямо сейчас, в какой он сети, перенесён ли к другому оператору и не находится ли абонент в роуминге. На телефон ничего не приходит: ни звонка, ни SMS, поэтому владелец номера проверку не замечает.
Вы отправляете номер
В личном кабинете, файлом CSV или одним вызовом API.
Bitcall направляет запрос
В домашнюю сеть, которой принадлежит номер.
HLR отвечает
Статус, обслуживающая сеть, перенос и роуминг.
Вы получаете результат
На экране, в выгрузке или в ответе API.
Зачем компании делают HLR-запросы
Компании делают HLR-проверку перед SMS-рассылкой, при регистрации пользователей и при маршрутизации звонков. Так они не платят за сообщения на несуществующие номера и отправляют перенесённые номера в ту сеть, где они на самом деле обслуживаются.
Ни звонка, ни SMS, ни уведомления: владелец номера никогда не узнает о проверке.
HLR и VLR
HLR и VLR работают вместе: когда телефон в роуминге, домашний HLR указывает на VLR гостевой сети. Поэтому запрос и может сказать, что абонент за границей.
| HLR | VLR | |
|---|---|---|
Кто ведёт | Домашний оператор абонента | Сеть, которой телефон пользуется сейчас |
Что хранит | Профиль каждого абонента и сеть, где он сейчас | Телефоны, которые сейчас в её зоне |
Срок | Постоянно | Временно, пока телефон там |
Что возвращает HLR-запрос
Каждый результат приходит структурированными данными: их можно фильтровать, выгружать или передавать в свои системы.
Статус в сети
CONNECTED
В сети ли номер сейчас, недоступен (выключен или вне зоны действия сети) или не существует.
Текущий оператор
Vodafone UK
Оператор, который обслуживает номер сегодня, с учётом переноса.
Исходный оператор
O2 UK
Оператор, которому изначально выделили диапазон номеров.
Перенесён
true
Перешёл ли номер к другому оператору, и если да, то к какому и в какой стране.
Роуминг
false
За границей ли телефон, и если да, то в какой сети и в какой стране.
MCC / MNC
234 / 15
Мобильные коды страны и сети обслуживающего оператора, для маршрутизации.
Страна
Великобритания · +44
Название страны, код ISO и телефонный код номера.
Доступен
true
Готовое «да» или «нет» на основе статуса, для простой фильтрации.
Пример ответа API (сокращённо)
{
"data": {
"status": "completed",
"price": {
"amount": 0.0038,
"currency": "EUR"
},
"result": {
"connectivityStatus": "CONNECTED",
"reachable": true,
"mccmnc": "23415",
"mcc": "234",
"mnc": "15",
"currentNetwork": "Vodafone UK",
"originalNetwork": "O2 UK",
"originalCountryName": "Великобритания",
"originalCountryCode": "GB",
"originalCountryPrefix": "44",
"ported": true,
"portedNetworkName": "Vodafone UK",
"roaming": false
}
}
}Значения статуса
- CONNECTED
- Зарегистрирован в сети и доступен прямо сейчас.
- ABSENT
- Сейчас не зарегистрирован: выключен, вне зоны действия сети или не используется.
- INVALID_MSISDN
- Номер не существует: он не выдан ни одному абоненту.
- UNDETERMINED
- Сеть не дала однозначного ответа.
Цены на HLR-запросы
Три запроса на три вопроса. Цена указана за номер и списывается, только если запрос успешен.
MNP-запрос
У какого оператора этот номер?
от€0.0030за запрос
- Перенесён или нет
- Исходный и текущий оператор
- MCC/MNC текущей сети
- Дата переноса, если оператор её передаёт
HLR-запрос
Активен ли номер прямо сейчас?
от€0.0038за запрос
- В сети, недоступен или не существует
- Текущий и исходный оператор
- Перенос и роуминг
- MCC/MNC для маршрутизации
Тип номера
Мобильный, городской или VoIP?
от€0.0038за запрос
- Тип линии: мобильный, городской, VoIP, бесплатный
- Оператор, которому принадлежит диапазон
- Страна и MCC/MNC
- Отсеять городские номера перед SMS-рассылкой
- Без абонплаты и минимального платежа
- Неудачные запросы не списываются
- Большие объёмы? Написать нашей команде
- Сначала попробуйте: попросите €0.10 бесплатного кредита
Массовая проверка номеров через HLR
Очистите базу номеров перед рассылкой за несколько кликов.
- Вставьте номера списком или загрузите файл CSV или TXT, до 10 000 номеров в пакете
- Номера очищаются, а дубликаты удаляются автоматически
- Следите за ходом проверки в реальном времени
- Скачивайте результаты в JSON, CSV или XLSX; выгрузки хранятся 30 дней
- Каждый пакет остаётся в истории запросов
Проверено 7 420 из 10 000
- +44 7700 900123В сети
- +44 7700 900456Недоступен
- +44 7700 900789Не существует
- В сети
- 6,912
- Недоступен
- 388
- Не существует
- 120
[
{ "inputValue": "447700900123", "resultStatus": "success", "currentNetwork": "Vodafone UK", "reachable": true, … },
{ "inputValue": "447700900456", "resultStatus": "success", "currentNetwork": "O2 UK", "reachable": false, … },
{ "inputValue": "447700900789", "resultStatus": "success", "currentNetwork": "Vodafone UK", "reachable": false, … }
]inputValue,resultStatus,currentNetwork,reachable,… 447700900123,success,Vodafone UK,true,… 447700900456,success,O2 UK,false,… 447700900789,success,Vodafone UK,false,…
inputValue | resultStatus | currentNetwork | reachable | … |
|---|---|---|---|---|
447700900123 | success | Vodafone UK | true | … |
447700900456 | success | O2 UK | false | … |
447700900789 | success | Vodafone UK | false | … |
API для HLR-запросов
Один запрос проверяет номер. Ещё один отправляет пакет до 10 000 номеров.
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":"447700900123"}'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: '447700900123' })
})
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": "447700900123"},
)
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":["447700900123","447700900456"]}' | 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": "Vodafone UK"
}
}
}Для чего команды используют HLR-запросы
Один и тот же запрос отвечает на разные вопросы маркетинга, безопасности и маршрутизации.
Очистка базы перед SMS-рассылкой
Сначала уберите недоступные и несуществующие номера, чтобы каждое оплаченное сообщение дошло до телефона, который может его принять.
Защита от фейковых регистраций
Проверяйте номер при регистрации и отмечайте те, что не являются активными мобильными, ещё до отправки кода подтверждения.
Верная маршрутизация перенесённых номеров
Операторы и реселлеры по MCC/MNC и данным о переносе отправляют звонки и SMS в сеть, где номер обслуживается на самом деле.
Реселлерская программаАктуальная CRM
Регулярно перепроверяйте старые контакты и отмечайте номера, которые перестали существовать или сменили оператора.
Bitcall HLR-запрос в сравнении
Те же HLR-, MNP-запросы и проверка типа номера, но без ежемесячной платы, с оплатой криптовалютой и без списаний за неудачные запросы.
| Bitcall | hlr-lookups.com | hlrlookup.com | NeutrinoAPI | Twilio Lookup | seven.io | Messente | |
|---|---|---|---|---|---|---|---|
Цена HLR-запроса | От €0.0038 | €0.0100 | €0.0058 | €0.0061 | $0.0070 | €0.0100 | €0.002 + €199 в месяц |
MNP-запросы | от €0.0030 | Да | Не указано на их сайте | Не указано на их сайте | Не указано на их сайте | Да | Не указано на их сайте |
Проверка типа номера | €0.0038 | Да | Не указано на их сайте | Не указано на их сайте | Да | Не указано на их сайте | Не указано на их сайте |
Без ежемесячной платы | Да | Да | Да | Не указано на их сайте | Да | Не указано на их сайте | ✕ Нет |
Оплата только за успешные запросы | Неудачные не списываются | Не указано на их сайте | Да | Не указано на их сайте | Не указано на их сайте | Не указано на их сайте | Не указано на их сайте |
Оплата криптовалютой | BTC, USDT, ETH | Да | Не указано на их сайте | ✕ Нет | Не указано на их сайте | Да | Не указано на их сайте |
Массовая загрузка в веб-кабинете | 10 000 в пакете | Да | Да | Не указано на их сайте | Не указано на их сайте | Да | Да |
REST API | Да | Да | Да | Да | Да | Да | Да |
Выгрузка в JSON, CSV и XLSX | Да | Не указано на их сайте | Не указано на их сайте | Не указано на их сайте | Не указано на их сайте | Не указано на их сайте | Не указано на их сайте |
Вопросы об HLR-запросах
Прямые ответы о том, как работают HLR-запросы и сколько они стоят.
HLR-запрос — это запрос в реальном времени к Home Location Register мобильного оператора, базе, в которой учтён каждый абонент сети. Он показывает, в сети ли номер, какой оператор его обслуживает, перенесён ли он и не в роуминге ли абонент.
Да. HLR-запросы — стандартный инструмент SMS-платформ, операторов связи и антифрод-команд. Запрос возвращает сетевые данные о номере: статус, оператора, перенос и роуминг. Имени и адреса абонента он не возвращает.
Сделайте HLR-запрос. CONNECTED означает, что номер обслуживается и телефон прямо сейчас зарегистрирован в сети. ABSENT — телефон выключен, вне зоны действия сети или сейчас не зарегистрирован. INVALID_MSISDN — номер не существует, он никому не выдан. Недоступные номера могут снова появиться в сети, поэтому перепроверьте их, прежде чем удалять.
HLR-запрос спрашивает живую сеть о статусе, текущем операторе, переносе и роуминге. MNP-запрос определяет оператора по базе перенесённых номеров: он показывает, в какой сети номер сейчас, без статуса в сети, и стоит дешевле. Проверка типа номера показывает, мобильный это номер, городской, VoIP или другой.
Перенесённый номер перешёл к другому мобильному оператору, сохранив те же цифры, поэтому код номера больше не говорит, какая у него сеть. В России перенос номера (MNP) работает с 2013 года, в Казахстане — с 2014-го. MNP-запрос или HLR-запрос, который включает данные о переносе, покажет, перенесён ли номер, какому оператору он был выделен и в какой сети обслуживается сейчас, вместе с MCC/MNC этой сети.
От €0.0038 за номер для HLR, €0.0030 для MNP и €0.0038 за проверку типа номера. Списываются только успешные запросы, с предоплаченного баланса, без абонплаты и минимального платежа. Для больших объёмов цена по запросу.
Нет. Сумма резервируется при отправке и возвращается за каждый номер, который отклонён или не проверился, поэтому оплачиваются только успешные запросы. Отмена пакета до запуска тоже снимает резерв.
Да. Вставьте номера списком или загрузите файл CSV или TXT в личном кабинете, до 10 000 номеров в пакете, или отправьте их одним вызовом API. Результаты можно скачать в JSON, CSV или XLSX.
Да. REST API принимает один номер или пакет до 10 000, а API-ключи имеют отдельные права на чтение и запись. Документация HLR API описывает каждый метод с примерами.
Сделайте проверку типа номера: она показывает, мобильный ли номер, городской, VoIP, бесплатный (например, 8 800), платный или другого типа. Сам HLR-запрос работает только для мобильных номеров, потому что HLR есть только у мобильных сетей.
Мобильные номера по всему миру, включая США, Казахстан и Узбекистан. Охват зависит от каждого оператора: если сеть не отвечает на живые HLR-запросы, ответ может прийти из базы перенесённых номеров.
Попросите у нашей команды €0.10 бесплатного тестового кредита, это около 25 HLR-запросов, и проверьте свои номера. Дальше HLR-запрос стоит от €0.0038, без абонплаты. Чтобы узнать, корректен ли номер, к какому оператору и региону он относится и какого он типа, воспользуйтесь бесплатной проверкой номера телефона: это бесплатно и без ограничений.
Нет. На HLR-запрос отвечает сеть, а не телефон. Ни звонка, ни SMS, ни уведомления на устройстве не будет.
Проверьте следующую базу до рассылки
Создайте бесплатный аккаунт, пополните баланс картой, через PayPal или криптовалютой и сделайте первый запрос за несколько минут.