identifierНомер
+12345678900Номер в том виде, в каком его возвращает API, в формате E.164.
Отправьте один номер, и в том же ответе придёт его исходное выделение: оператор, тип линии, страна и регион выделения. Изучите поля до интеграции.
Иллюстративный пример · не реальный запрос
Отделы продаж, рассылок, рисков и телеком-аналитики задают разные вопросы об одном номере.

Дополните существующую запись данными об операторе, стране, регионе и типе номера. Отделы продаж, рассылок и оценки рисков смогут заметить расхождения, назначить проверку и выбрать следующий шаг.
Постоянный тестовый образец CarrierLookup; отсутствующие поля помечены как не возвращённые.Одни и те же поля помогают разным командам, когда попадают в рабочие записи. Эти сценарии основаны на типичных бизнес-задачах.
Новый лид поступает в CRM с телефоном и указанной страной. Дополните оператора и регион выделения перед передачей в продажи.
Сохраните исходного оператора, страну выделения и регион в отдельных полях рядом с данными клиента.
Отдел продаж увидит данные клиента и контекст номера перед первым контактом.
При передаче лида отдел продаж сравнивает Канаду с US, уточняет рынок и ответственного, затем сохраняет оба значения и время запроса в CRM до смены назначения.
Поля получены из реального теста; записи и статусы иллюстрируют возможный процесс.
Поля помогают дополнять записи, замечать расхождения, фиксировать основания и передавать задачи на следующий этап.
Смотреть рабочие примерыИспользуйте возвращённые поля оператора, типа номера и местоположения, чтобы упорядочить записи о номерах телефонов.
POST /api/v1/check200 OKidentifierНомер в том виде, в каком его возвращает API, в формате E.164.
number_typeТип линии в том виде, в каком его сообщает поставщик данных, — для номеров США обычно это «Fixed Line or Mobile», что не разделяет эти два типа.
country_codeДвухбуквенный код страны ISO.
carrierОператор, которому номер был изначально выделен. Не текущий оператор после переноса.
regionРегион выделения — код штата или провинции. Может быть пустым.
cityГород выделения в написании поставщика; иногда это код телефонной станции, а не название места. Никогда не текущее местоположение.
Пустое необязательное поле не делает запрос недействительным.Описание полей →
Посмотрите, как номер из списка команды превращается в запись с данными об операторе.

Команда Майи получает список телефонов для обработки. В нём есть номера, но мало контекста для передачи. Она сначала проверяет один номер и добавляет исходного оператора и код страны для дальнейшей сверки и группировки.
Исходный номер сохраняют, а carrier и country_code добавляют отдельными столбцами с источником. Следующий сотрудник видит T-Mobile и US и решает, какие записи требуют проверки.
Изучите запрос для одного номера и типизированный ответ, затем вызовите тот же эндпоинт со своим ключом API.
Только исходное выделение. Без заявлений о текущем операторе, доступности или местоположении в реальном времени.
Документация APIcurl "https://api.carrierlookup.online/api/v1/check" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service_type":"carrier",
"identifier":"+12345678900"}'Платите за то, что проверяете, — подписка не обязательна. Один баланс покрывает все ваши проверки.
Постоянное пополнение
Зачисляется на баланс19,90 $
Баланс никогда не сгорает. Используйте его для всех продуктов в вашем аккаунте.
Все тарифы →30-дневные тарифы
Зачисляется на баланс10,40 $
Те же расходы — больше бонусного баланса. Продлевается каждые 30 дней.
Все тарифы →
Бесплатный или платный API для определения оператора: сравните ответ до ценыСравните данные об исходном операторе, методы доступа, объемы и условия баланса перед выбором бесплатной проверки или платного API.Читать статью
Объединение CSV-файла Carrier Lookup с исходными записями контактовПрактическое руководство по объединению данных Carrier Lookup с исходными записями контактов с учетом ограничений запросов и этапов проверки для команд.Читать статью
Разделение списка номеров разных стран на задачи Определение исходного оператораСоздайте манифест «страна-файл», проверьте исключенные номера и отправьте отдельные массовые задачи Определение исходного оператора с отслеживаемыми результатами.Читать статью
Добавление этапа проверки перед выполнением запросов Carrier Lookup с помощью ИИ-ассистентаРабочий процесс утверждения MCP для Carrier Lookup должен показывать оператору нормализованные номера и инструмент перед выполнением платного запроса.Читать статью
Миграция некорректно размеченного поля оператора в CRM с использованием смешанных источниковМигрируйте некорректно размеченное поле оператора по источникам, а не переименованием. Проведите инвентаризацию данных и отделите исходные от неподтвержденных.Читать статью
Очередь параллельных запросов Carrier Lookup API для общих учетных записейПрактическое руководство по организации очереди параллельных запросов Carrier Lookup API для общих учетных записей с учетом лимитов и этапов проверки.Читать статьюОтветы о данных оператора, балансе, доступе к API и неудачных запросах.
Отправьте один номер в формате E.164, и CarrierLookup вернёт в том же ответе сеть, которой он был изначально выделен, в виде полей верхнего уровня результата. Никаких очередей задач, опроса и обратных вызовов. На сам номер ничего не отправляется.
Запрос выполняется в реальном времени, а данные отражают исходное выделение — не путайте одно с другим. После отправки номера результат приходит в том же HTTP-ответе в виде полей верхнего уровня — без очереди задач, опроса и обратных вызовов. Возвращается сеть, которой изначально был выделен диапазон этого номера. Перенос номеров не учитывается, поэтому это не обязательно оператор, обслуживающий номер сегодня, и результат ничего не говорит о доступности номера. Панель, API для одного номера и синхронный API для нескольких номеров возвращают одни и те же поля.
Постоянный баланс покупается один раз и не продлевается. Баланс 30-дневного тарифа действует 30 дней с момента оплаты; неиспользованный остаток сгорает в конце текущего цикла. Тарифы автоматически продлеваются каждые 30 дней, пока вы не отключите автопродление. Отключение прекращает будущие списания; текущий тариф можно использовать до окончания срока. Средства за неудачные или неопределённые проверки возвращаются на соответствующий кошелёк.
Создайте бесплатный аккаунт и обратитесь в поддержку, чтобы получить 100 бесплатных проверок. Пополнить баланс можно в любое время.
Постоянное пополнение можно оплатить кредитной картой, другими поддерживаемыми картами или криптовалютой. 30-дневные тарифы оплачиваются картой на защищённой внешней странице оплаты и продлеваются каждые 30 дней. Оплата картой — без дополнительной комиссии. Для криптовалюты может взиматься комиссия за обслуживание, она показывается при оплате.
Создайте ключ API в настройках, затем вызовите /api/v1/check с заголовком X-API-Key, номером и service_type=carrier. Данные оператора вернутся в том же ответе JSON в виде полей верхнего уровня — carrier, underlying_carrier, number_type, country_code, region и city; несколько номеров можно отправить вместе через синхронный эндпоинт множественной проверки.
Нет. Результат сообщает только сеть, которой номер был изначально выделен. Он не учитывает перенос номеров и не означает, что номер сейчас доступен. Перед тем как с кем-либо связаться, вы по-прежнему отвечаете за наличие согласия и соблюдение применимых правил.
Зарегистрируйтесь и получите 100 бесплатных проверок через поддержку