Методология определения оператора
Как CarrierLookup определяет оператора номера
CarrierLookup возвращает оператора, которому номер был изначально выделен, для service_type=carrier — синхронно для одиночных и множественных запросов. На этой странице описаны процесс определения, формат номера и то, что результат сообщает и чего не сообщает.
Проверено 18 сентября 2026 г.
Что происходит при определении оператора?
CarrierLookup обрабатывает по одному номеру за раз: отправьте его в формате E.164, и поля оператора придут в том же HTTP-ответе. Они описывают сеть, которой номер был изначально выделен, — не текущего оператора после переноса и не то, доступен ли номер.
Выполнение одной проверки
Этот раздел посвящён проверкам в реальном времени: панель SaaS и синхронные эндпоинты REST используют один сервис проверки и одинаковое значение ответа. Для очень больших списков есть асинхронный массовый вариант — он описан в конце страницы.
- 1
Отправьте номер
Отправьте один полный номер, как описано в документации API.
- 2
Укажите service_type=carrier
Продукт carrier возвращает сеть, которой номер был изначально выделен, вместе с типом линии и регионом выделения.
- 3
Прочитайте результат
Прочитайте поля оператора в том же ответе. Они описывают исходное выделение номера, а не оператора, обслуживающего его сегодня.
В каком формате отправлять номер
CarrierLookup принимает один номер на запрос в формате E.164: знак плюс, код страны, затем номер абонента без пробелов и разделителей.
- Отправляйте полный номер с кодом страны. Национальный номер без него определить нельзя.
- Национальные форматы с ведущими нулями, пробелами, дефисами или скобками не принимаются — отправляйте только + и цифры.
- Номера в неверном формате отклоняются до списания; отклонённый формат — это не ответ «нет результата».
Что означают поля оператора?
Поля оператора — это ответ на запрос определения оператора: carrier, underlying_carrier, number_type, country_code, region и city на верхнем уровне успешного ответа. Они содержат изначально выделенного оператора и тип линии, страну, а также регион и город выделения, если их предоставляет поставщик данных. Флага registered нет — результатом является сам успешный ответ. Всё остальное — тайм-аут, неопределённый результат, недопустимый номер — возвращается как код ошибки, и средства за такой запрос возвращаются автоматически. Пустое значение никогда не означает «нет оператора»; это значит, что поставщик не предоставил это поле.
- carrier — сеть, которой номер был выделен при его выпуске.
- number_type, region и city могут быть пустыми, если поставщик их не предоставляет; сами ключи присутствуют всегда.
- Другие исходы обрабатывайте по коду ответа API; не выводите выделение самостоятельно.
Используйте результат в пределах его назначения
Результат описывает сеть, которой номер был изначально выделен. Это не проверка доступности номера, не подтверждение личности и не разрешение связываться с человеком.
- Результат не подтверждает, кому принадлежит номер, и не учитывает перенос номеров — для перенесённого номера по-прежнему возвращается оператор, которому изначально был выделен его диапазон.
- Результат с оператором не означает согласия на контакт с этим номером.
- Не считайте результат текущим оператором: повторный запрос вернёт то же исходное выделение, а не сеть, в которую номер мог быть перенесён.
Очень большие списки: асинхронный вариант
Множественная проверка в панели и множественный эндпоинт API покрывают большинство списков. Отправлять весь файл одной асинхронной массовой задачей имеет смысл, только когда список намного превышает эти лимиты.
- Загрузите .txt или .csv с одним номером на строку — на странице массовой проверки или через API.
- При загрузке выберите страну, к которой относятся номера; каждая строка всё равно должна быть в формате E.164.
- При отправке баланс резервируется за допустимые строки, списание идёт только за номера, по которым получен результат, а разница возвращается.
- Задача выполняется в фоне; скачайте файл с результатом после завершения. За неудавшуюся задачу сумма возвращается полностью.