проверка номера (MNP)

Оператор номера
с учётом переноса

Текущий оператор, признак переноса и прежний оператор, ИНН оператора и коды сети MCC/MNC — по номеру или пакетом до 1000.

Документация →
25M+
перенесённых номеров в базе
MCC/MNC
коды сети для маршрутизации
1000
номеров в одном запросе
POST
200 OKapplication/json, 7ms
{
  "query": "+7 962 730-23-71",
  "suggestions": [
    {
      "source": "89627302371",
      "phone": "+7 962 730-23-71",
      "type": "mobile",
      "is_valid": true,
      "country_code": "7",
      "city_code": "962",
      "number": "7302371",
      "extension": null,
      "operator": "ПАО \"ВымпелКом\"",
      "operator_inn": "7713076301",
      "operator_original": null,
      "ported": false,
      "mcc": "250",
      "mnc": "99",
      "country": "Россия",
      "region": "Республика Саха (Якутия)",
      "city": null,
      "timezone": "UTC+9",
      "qc": 0,
      "qc_conflict": 0
    }
  ]
}
что вы получаете

Возможности оператор номера

Оператор после переноса

Тот, кто обслуживает номер сейчас, а не тот, кому выдан диапазон.

ИНН и коды сети

ИНН оператора и пара MCC/MNC — 250-01, 250-99 — для SMS-шлюзов и биллинга.

Пакет до 1000

Тысяча номеров за запрос, ответ в том же порядке, лимит — по номеру.

Поля ответа 20

Ответ — структурированный JSON: каждый уровень отдельным полем, коды и координаты рядом со значением.

/v1/find/phone

ТелефонТипОператор связиИНН оператораНомер перенесёнОператор до переносаКод страны сети (MCC)Код сети (MNC)РегионЧасовой пояс
о сервисе

Что такое проверка оператора по номеру

С тех пор как номер можно забрать к другому оператору, код больше не говорит, чья это сим-карта: номер на 916 вполне может обслуживать T2, а на 977 — МТС. Метод отвечает, кто обслуживает номер сейчас: сверяет его с базой перенесённых номеров — это более 25 миллионов записей — и с планом нумерации. В ответе текущий оператор, признак переноса, прежний оператор, ИНН оператора и коды сети MCC/MNC, по которым SMS-шлюзы и биллинги узнают сеть, а также тип номера, регион и часовой пояс.

Как подключить проверка оператора по номеру

Метод вызывают перед отправкой сообщения, чтобы выбрать маршрут и тариф, при входе и платеже — как один из признаков для антифрода, и при загрузке клиентской базы — чтобы разметить номера по операторам и регионам. Номера отправляют по одному или пакетом до 1000, ответ приходит в том же порядке. Оператор и перенос открываются на тарифах «Бизнес» и «Корпоративный» и расходуют их дневной лимит: номер — один запрос, без отдельной платы за проверку. На остальных тарифах тот же метод отдаёт тип номера.

Что важно знать про проверка оператора по номеру

Источники — открытый план нумерации Минцифры и выгрузка базы перенесённых номеров. Обновления источников проверяются каждые сутки, поэтому только что перенесённый номер может показать прежнего оператора до следующего обновления. Код сети приходит для мобильных номеров операторов со своим кодом; у стационарных номеров и у операторов без собственного кода сети его нет. Метод не определяет владельца номера, его местоположение и то, включён ли телефон: эти сведения составляют тайну связи.

Как узнать оператора по номеру телефона, если номер перенесли

По первым цифрам номера видно только, кому выдан диапазон. После переноса номер остаётся прежним, а обслуживает его уже другой оператор — так переходят миллионы абонентов. Чтобы узнать текущего оператора, номер сверяют с базой перенесённых номеров: если он там есть, в ответе приходит новый оператор и отметка о переносе, если нет — оператор по плану нумерации.

MNP-запрос: зачем он SMS-рассылкам и антифроду

MNP — перенос номера между операторами, MNP-запрос — проверка, кто обслуживает номер сейчас. SMS-агрегаторам он нужен для маршрутизации: сообщение, отправленное «не в ту» сеть, идёт дороже или не доходит. Сервисам с входом по SMS — как признак риска: номер, недавно сменивший оператора, стоит проверить внимательнее перед восстановлением доступа или крупным платежом.

Коды MCC и MNC по номеру телефона

MCC — код страны мобильной сети, у России это 250. MNC — код конкретной сети: МТС — 01, МегаФон — 02, T2 — 20, Yota — 11, Билайн — 99. Пара 250-01 одинаково понятна SMS-шлюзу, биллингу и роуминговой системе в любой стране, поэтому её отдают отдельными полями рядом с названием оператора. ИНН оператора помогает сверить его с реестрами и договорами.

Откуда данные и как часто они обновляются

Оператор и регион берутся из плана нумерации, который ведёт Минцифры, перенос — из выгрузки базы перенесённых номеров. Обновления обоих источников проверяются каждые сутки и выкладываются без остановки сервиса. Название оператора приходит в одном написании для всех его номеров, а ИНН позволяет не путать операторов с похожими названиями.

тарификация

Тариф «Бизнес»

Оператор, перенос, ИНН и коды сети открываются на тарифах «Бизнес» и «Корпоративный» и расходуют их дневной лимит — номер считается одним запросом. На остальных тарифах тот же метод отдаёт тип номера.

в тарифе«Бизнес» и «Корпоративный»
Все тарифы и цены →
вопросы

Частые вопросы про проверка оператора по номеру

Как узнать оператора по номеру, если абонент перешёл к другому оператору?
Отправьте номер в метод /v1/find/phone. Если номер переносили, придёт текущий оператор, отметка ported и прежний оператор в поле operator_original.
Сколько стоит проверка оператора?
Она входит в тарифы «Бизнес» и «Корпоративный»: номер расходует один запрос дневного лимита, отдельной платы за номер нет. На остальных тарифах тот же метод отдаёт тип номера.
Что такое MCC и MNC?
Это международные коды мобильной сети: MCC — страна (у России 250), MNC — сеть внутри страны (у МТС 01, у Билайна 99). По ним сеть однозначно узнают SMS-шлюзы и биллинги.
Можно ли узнать владельца номера или где он находится?
Нет. Сервис показывает оператора и регион выдачи номера. Владелец, местоположение и активность номера составляют тайну связи — их метод не определяет.
Сколько номеров можно проверить за раз?
До 1000 в одном запросе, ответ сохраняет порядок номеров. Базу любого размера проверяют пакетами подряд.
Есть ли совместимость с DaData?
Текущий оператор с учётом переноса есть и в стандартизации телефона /clean/phone — она совместима с форматом DaData и оплачивается за запись. Метод проверки номера — свой: в нём есть признак переноса, ИНН оператора и коды MCC/MNC, которых в формате DaData нет.

Чистые данные за один запрос

Подключите тариф «Бизнес» — оператор и перенос придут в том же ответе, без оплаты за каждый номер.

Документация