Запрос cURL
POST /api/v1/bulk-taskscurl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=number_validation_batch \
-F country=US \
-F [email protected]Валидация номеров
Получайте сигнал валидности или активации каждого номера через асинхронное файловое задание. Результаты true/false помогают проверять импортированные списки, очищать данные и обновлять CRM.
Этот продукт доступен только как асинхронная обработка файла. Проверка оператора в реальном времени не возвращает признаки валидности или активности.
Два шага: отправьте файл, затем проверьте задачу
При отправке сразу возвращается id задачи; проверяйте задачу по этому id, и после успешного завершения ответ будет содержать ссылку для скачивания файла результата. Каждый запрос показан вместе со своим ответом.
1. Отправьте файл
id задачи возвращается сразу с preparing = true, пока файл подготавливается в фоне: некорректные строки, дубликаты и — для задач с номерами — номера без кода страны или из другой страны удаляются и не оплачиваются. Баланс резервируется за отправленные строки, а расчёт производится по завершении; разница возвращается.
Ответ: задача создана
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "processing",
"country": "US",
"submitted_lines": 509,
"total": 509,
"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://api.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": "number_validation_batch",
"status": "success",
"country": "US",
"submitted_lines": 509,
"total": 500,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 6,
"preparing": false,
"success_cnt": 495,
"failure_cnt": 5,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Что происходит с массовой задачей
Массовая проверка — это не увеличенная проверка в реальном времени, а схема «отправили один раз, выполняется в фоне, забрали позже». Держать страницу открытой не нужно: состояние задачи и результаты сохраняются в вашей панели.
01Загрузите файл
Файл .txt или .csv с одним номером на строку. Он передаётся потоком напрямую, ничего не записывается на диск.
02Предпроверка и резервирование
Очевидные проблемы (пустой файл, неверный формат, слишком мало строк) отклоняются при загрузке. Затем резервируется баланс, и файл подготавливается в фоне: удаляются дубликаты и некорректные строки, а также проверяется правило страны. Файл, не прошедший этот этап, завершается как неудавшаяся задача с полным возвратом средств; в противном случае проверяются только оставшиеся строки, а расчёт по задаче производится по её завершении.
03Выполнение в фоне
Задача выполняется самостоятельно — страницу можно закрыть. О сбое сообщается сразу, и средства возвращаются полностью.
04Скачайте результат
Заберите файл на странице массовой проверки. Вы платите только за номера, по которым действительно получен результат; разница возвращается.
Столбцы файла результата
Для скачивания предоставляется один файл CSV с полной таблицей результатов.
Столбцы файла результата
identifier·12345678900— Отправленный номер в виде цифр с кодом страны, без знака плюс и пробелов (например, 12345678900), — стабильный ключ для сопоставления результатов с клиентом, лидом или записью CRM. Сохраняйте его, чтобы отслеживать исходный список и массово записывать результаты обратно; само по себе это поле не подтверждает, что с номером можно связаться.activated·true— Решение о валидности/активации: true — совпадение, false — явный отрицательный результат. Не заменяйте отсутствующие или ошибочные результаты на false. Поле не подтверждает личность, разрешение на контакт или доступность звонка.
Когда выбирать этот продукт
Проверка списков регистраций
После импорта регистраций или лидов проверяйте результаты вместе с данными форм, правилами антифрода и согласием. Асинхронная проверка не заменяет проверку кода при регистрации в реальном времени.
Свяжите identifier с исходной записью и сохраните источник для ручной проверки.
Ключ сопоставления: identifier
Очистка списков
После выгрузки помечайте записи по сигналу активации, сохраняя исходный номер и поля источника; отсутствующие или необычные сигналы направляйте на проверку, а не удаляйте бизнес-данные сразу.
Разделяйте true, false и отсутствующие результаты; оставляйте последние в очереди проверки.
Поле сегментации: activated
Гигиена CRM
Записывайте дату проверки, продукт и результат в отдельные поля CRM, чтобы команды маркетинга, поддержки и данных работали с единым статусом списка в последующих процессах.
Сохраните результат с датой задания, записанной вашей командой. Для обновления отправьте новое задание.
Поля обновления: identifier · activated
Что такое «Валидация номеров» в массовом режиме?
Массово проверяйте номера в формате E.164 перед рассылкой и получайте сигналы о номере и его активации. Используйте результат, чтобы отмечать записи для проверки, очищать списки и поддерживать качество данных в CRM; полученный сигнал не гарантирует, что звонок или сообщение будут доставлены.
Ограничения этого продукта
- Интерпретируйте activated в зависимости от выбранного продукта: валидность/активация или активность. Даты и частота активности не возвращаются.
- Результат не подтверждает личность или согласие и не гарантирует соединение звонка или доставку сообщения.
- Результаты не обновляются автоматически. Для повторной проверки отправьте новую задачу.
О продукте «Валидация номеров»
Что означают true, false и отсутствие результата?
True — совпадение в этой проверке, false — явный отрицательный результат. Оба являются полученными решениями; false не означает ошибку выполнения или бесплатную строку. Обрабатывайте отсутствующие, неопределённые и ошибочные результаты отдельно по статистике задания и итоговому расчёту; не заполняйте их значением false.
Показывает ли это активность за последние дни или гарантирует доставку?
Нет. Результаты не содержат периода наблюдения, даты последней активности, частоты или истории взаимодействий и не гарантируют звонок или доставку сообщения. Используйте со своими данными и разрешением на контакт.
Доступна ли эта проверка в реальном времени?
Этот продукт доступен только как асинхронная обработка файла. Проверка оператора в реальном времени не возвращает признаки валидности или активности.
Что происходит с некорректными номерами в файле?
Предпроверка отбрасывает некорректные строки, поэтому они не попадают в оплачиваемое количество. Из оставшихся номеров те, которые вышестоящий сервис не смог определить, тоже не оплачиваются. Вы платите только за номера, по которым действительно получен результат.
Сколько времени занимает задача?
Это зависит от количества номеров и продукта. После отправки страницу можно закрыть: задача выполняется в фоне, а результат будет ждать вас на странице массовой проверки.
Вернутся ли средства, если задача не удалась?
Да. За неудавшуюся задачу средства возвращаются полностью. Если задача выполнена, но по части номеров нет результата, эта часть возвращается автоматически. Разница между зарезервированной и фактически списанной суммой всегда возвращается.
Другие массовые продукты
Глобальное определение оператораЗагрузите целый файл с номерами: оператор, базовый оператор, тип линии, страна, регион и город для каждого — те же поля, что и при определении оператора в реальном времени.Активность номеровПолучайте сигнал активности каждого номера через асинхронное файловое задание. Сопоставляйте true/false со своими данными о взаимодействиях для проверки сегментов и приоритетов контакта.Создайте аккаунт, чтобы отправить массовую задачу
Массовые проверки и проверки в реальном времени расходуют один баланс — ничего дополнительно включать не нужно. Зарегистрируйтесь и загрузите первый файл на странице массовой проверки.