Запрос cURL
POST /api/v1/bulk-taskscurl -X POST "https://carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=carrier_batch \
-F country=US \
-F file=@numbers.txtМассовый продукт carrier_batch
Глобальное определение оператора
Загрузите целый файл с номерами: оператор, базовый оператор, тип линии, страна, регион и город для каждого — те же поля, что и при определении оператора в реальном времени.
Дополнение для больших списков целиком — для нескольких номеров проверка в реальном времени отвечает в том же запросе. Проверка в реальном времени →
Контракт API
Два шага: отправьте файл, затем проверьте задачу
При отправке сразу возвращается id задачи; проверяйте задачу по этому id, и после успешного завершения ответ будет содержать ссылку для скачивания файла результата. Каждый запрос показан вместе со своим ответом.
1. Отправьте файл
id задачи возвращается сразу с preparing = true, пока файл подготавливается в фоне: некорректные строки, дубликаты и — для задач с номерами — номера без кода страны или из другой страны удаляются и не оплачиваются. Баланс резервируется за отправленные строки, а расчёт производится по завершении; разница возвращается.
Ответ: задача создана
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "carrier_batch",
"status": "processing",
"country": "US",
"submitted_lines": 1015,
"total": 1015,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}2. Проверьте задачу
Опрашивайте по id задачи. После завершения подготовки submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, где total — количество проверяемых и оплачиваемых номеров. Успешный ответ содержит количество успешных и неудачных проверок и ссылку для скачивания файла результата; задача, отклонённая при подготовке, получает статус failed с reason_detail, и средства возвращаются полностью.
Запрос cURL
GET /api/v1/bulk-tasks/{id}curl "https://carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Ответ: задача завершена
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "carrier_batch",
"status": "success",
"country": "US",
"submitted_lines": 1015,
"total": 1000,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 12,
"preparing": false,
"success_cnt": 990,
"failure_cnt": 10,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Как это работает
Что происходит с массовой задачей
Массовая проверка — это не увеличенная проверка в реальном времени, а схема «отправили один раз, выполняется в фоне, забрали позже». Держать страницу открытой не нужно: состояние задачи и результаты сохраняются в вашей панели.
01Загрузите файл
Файл .txt или .csv с одним номером на строку. Он передаётся потоком напрямую, ничего не записывается на диск.
02Предпроверка и резервирование
Очевидные проблемы (пустой файл, неверный формат, слишком мало строк) отклоняются при загрузке. Затем резервируется баланс, и файл подготавливается в фоне: удаляются дубликаты и некорректные строки, а также проверяется правило страны. Файл, не прошедший этот этап, завершается как неудавшаяся задача с полным возвратом средств; в противном случае проверяются только оставшиеся строки, а расчёт по задаче производится по её завершении.
03Выполнение в фоне
Задача выполняется самостоятельно — страницу можно закрыть. О сбое сообщается сразу, и средства возвращаются полностью.
04Скачайте результат
Заберите файл на странице массовой проверки. Вы платите только за номера, по которым действительно получен результат; разница возвращается.
Поля результата
Столбцы файла результата
Для скачивания предоставляется один файл CSV с полной таблицей результатов.
Столбцы файла результата
identifier·17253100591— Отправленный номер в виде цифр с кодом страны, без знака плюс и пробелов (например, 17253100591).carrier·T-Mobile— Оператор, которому номер был изначально выделен. Не текущий оператор после переноса.underlying_carrier— Базовый оператор, сообщённый поставщиком данных, если он отличается от выделенного; пусто, если поставщик его не предоставляет.number_type·Fixed Line or Mobile— Тип линии, сообщённый поставщиком данных, например Fixed Line or Mobile; пусто, если недоступен.country_code·US— Код страны ISO, к которой относится номер.region·CA— Регион выделения; пусто, если поставщик его не предоставляет.city·LOS ANGELES— Город выделения; пусто, если поставщик его не предоставляет.
Лучше всего подходит для
Когда выбирать этот продукт
Сегментация списков
Упорядочьте весь список номеров по исходному оператору, типу линии и стране или региону выделения в скачиваемом файле результатов.
Анализ затрат на маршрутизацию
Используйте столбцы оператора и региона, чтобы сверять внутренние записи о маршрутизации, закупках или затратах, не проверяя номера по одному.
Гигиена базы данных
Находите записи номеров без исходного оператора, региона или города и составляйте список для дополнения и ручной проверки. Разделяйте пустые, неполные и противоречивые записи, чтобы они незаметно не попали в дальнейший анализ.
Рекомендуемый процесс: пометьте записи для проверки, выгрузите список для дополнения данных, затем запишите его обратно или выполните определение повторно.
Краткий ответ
Что такое «Глобальное определение оператора» в массовом режиме?
Массовое определение оператора — файловая версия определения в реальном времени для списков от тысячи номеров: загрузите файл, задача выполнится в фоне, и вы скачаете один CSV с результатом и одинаковыми полями для каждого номера. Каждый номер должен содержать код страны, а все номера в одном файле должны относиться к стране, выбранной при загрузке; номера без кода страны или из другой страны исключаются и не оплачиваются.
Чёткие границы
Ограничения этого продукта
- Результат описывает сеть, которой номер был изначально выделен. Перенос номеров не учитывается, поэтому это не обязательно оператор, обслуживающий номер сегодня.
- Это не проверка доступности и не подтверждение личности: результат не говорит ни о том, обслуживается ли номер, ни о том, кому он принадлежит.
- На номера из файла ничего не отправляется — определение выполняется по данным о выделении номеров.
- Результаты отражают данные о выделении номеров на момент выполнения задачи, а сохранённые результаты автоматически не обновляются. Повторный запуск файла не покажет операторов, к которым номера были перенесены.
- Ссылки для скачивания имеют ограниченный срок действия. Скачайте файл вскоре после завершения задачи; если ссылка истекла, проверьте задачу снова, чтобы получить новую.
Когда подходит массовая проверка
Когда массовая проверка оправдана, а когда быстрее проверка в реальном времени
| Проверка в реальном времени | Массовая проверка | |
|---|---|---|
| Сколько номеров | 1 номер на одиночную проверку; несколько — в множественном запросе, точные лимиты указаны в документации API | Большой список целиком в одной задаче — текущий диапазон размеров указан на странице цен |
| Получение результатов | Сразу: одиночный и множественный эндпоинты отвечают в том же ответе; панель возвращает результаты по одному | Скачайте файл с результатом после завершения задачи |
| Страна | Выбирать не нужно — каждый номер содержит свой код страны, в одном запросе можно смешивать любые | Одна страна на задачу, выбирается при загрузке и отправляется вместе с файлом |
| Формат результата | JSON, поля по каждому номеру | Файл результата (один CSV с полной таблицей) |
| Типичное применение | Обогащение CRM при вводе, запросы операторов поддержки, правила маршрутизации | Сегментация списков, анализ затрат на маршрутизацию, гигиена базы данных |
FAQ по продукту
О продукте «Глобальное определение оператора»
Когда использовать массовую проверку вместо проверки в реальном времени?
Используйте массовую проверку для большого списка целиком. Для нескольких номеров проверка в реальном времени отвечает в том же запросе, без планирования задачи.
Что происходит с некорректными номерами в файле?
Предпроверка отбрасывает некорректные строки, поэтому они не попадают в оплачиваемое количество. Из оставшихся номеров те, которые вышестоящий сервис не смог определить, тоже не оплачиваются. Вы платите только за номера, по которым действительно получен результат.
Сколько времени занимает задача?
Это зависит от количества номеров и продукта. После отправки страницу можно закрыть: задача выполняется в фоне, а результат будет ждать вас на странице массовой проверки.
Вернутся ли средства, если задача не удалась?
Да. За неудавшуюся задачу средства возвращаются полностью. Если задача выполнена, но по части номеров нет результата, эта часть возвращается автоматически. Разница между зарезервированной и фактически списанной суммой всегда возвращается.
Создайте аккаунт, чтобы отправить массовую задачу
Массовые проверки и проверки в реальном времени расходуют один баланс — ничего дополнительно включать не нужно. Зарегистрируйтесь и загрузите первый файл на странице массовой проверки.