Obtén una señal de validez o activación por número mediante una tarea de archivo asíncrona. Los resultados true/false ayudan a revisar listas importadas, depurar datos y mantener el CRM.
Este producto solo está disponible como tarea asíncrona con archivo. La consulta de operador en tiempo real no devuelve señales de validez ni de actividad.
Al enviar se devuelve de inmediato un ID de tarea; consulte la tarea con ese ID y, cuando se complete correctamente, la respuesta incluirá el enlace de descarga del archivo de resultados. Cada solicitud se muestra con su propia respuesta.
El ID de tarea se devuelve de inmediato con preparing en true mientras el archivo se prepara en segundo plano: se eliminan las líneas no válidas, los duplicados y, en las tareas de números, los números sin código de país o de otro país, que no se cobran. El saldo se reserva para las líneas enviadas y se liquida al completarse; la diferencia se reembolsa.
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]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"
}
}Sondee por ID de tarea. Cuando finaliza la preparación, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, donde total es lo que se verifica y se cobra. Una respuesta correcta incluye los recuentos de éxitos y fallos y el enlace de descarga del archivo de resultados; una tarea rechazada durante la preparación queda en failed con reason_detail y se reembolsa íntegramente.
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"
}
}El modo masivo no es una versión ampliada del tiempo real: se envía una vez, se ejecuta en segundo plano y se recoge más tarde. No necesita mantener la página abierta; el estado de la tarea y los resultados permanecen en su panel.
Un archivo .txt o .csv con un número por línea. Se transmite directamente; no se escribe nada en disco.
Los problemas evidentes (un archivo vacío, un formato incorrecto, muy pocas líneas) se rechazan al subirlo. A continuación se reserva el saldo y el archivo se prepara en segundo plano: se eliminan las líneas duplicadas y no válidas, y se comprueba la regla de país. Un archivo que no supera esa fase termina como tarea fallida y se reembolsa íntegramente; en caso contrario, solo se verifican las líneas restantes y la tarea se liquida al completarse.
La tarea se ejecuta por sí sola: puede cerrar la página si lo desea. Un fallo se notifica de inmediato y se reembolsa íntegramente.
Recoja el archivo en la página de verificación masiva. Solo paga por los números que realmente devolvieron un resultado; la diferencia se reembolsa.
La descarga es un único archivo CSV con la tabla de resultados completa.
identifier · 12345678900 — El número enviado en dígitos sin formato con el código de país, sin signo más ni espacios (p. ej., 12345678900), y la clave estable para asociar los resultados a un cliente, lead o registro del CRM. Consérvelo para rastrear la lista de origen y volver a escribir los resultados de forma masiva; el campo por sí solo no establece que se pueda contactar con el número.activated · true — Decisión de validez/activación: true es una coincidencia y false un negativo explícito. No sustituyas resultados ausentes o fallidos por false. No prueba identidad, permiso de contacto ni disponibilidad para llamadas.Tras importar registros o leads, revisa los resultados junto con formularios, reglas antifraude y consentimiento. Esta comprobación asíncrona no sustituye la verificación de códigos en tiempo real.
Relaciona identifier con el registro original y conserva la fuente para la revisión manual.
Clave de unión: identifier
Tras la exportación, marque los registros según la señal de activación conservando el número original y los campos de origen; envíe a revisión las señales ausentes o inusuales en lugar de eliminar directamente datos de negocio.
Separa true, false y resultados ausentes; conserva los ausentes en la cola de revisión.
Campo de agrupación: activated
Escriba la fecha de verificación, el producto y el resultado en campos dedicados del CRM para que los equipos de marketing, servicio y datos trabajen con el mismo estado de lista en flujos posteriores.
Guarda el resultado con la fecha de tarea registrada por tu equipo. Envía otra tarea para actualizarlo.
Campos de actualización: identifier · activated
Compruebe números E.164 de forma masiva antes de contactar y obtenga el número y las señales de activación. Use el resultado para marcar registros para revisión, depurar listas y mantener la calidad de los datos del CRM; una señal devuelta no garantiza que una llamada o un mensaje se conecte.
True es una coincidencia y false un negativo explícito de esta prueba. Ambos son decisiones obtenidas; false no significa fallo de ejecución ni fila gratuita. Trata los resultados ausentes, indeterminados y fallidos por separado según las estadísticas y la liquidación final; no los rellenes con false.
No. No incluye ventana de observación, última actividad, frecuencia ni historial de interacción y no garantiza llamadas ni mensajes. Úsalo junto con tus datos y el permiso de contacto.
Este producto solo está disponible como tarea asíncrona con archivo. La consulta de operador en tiempo real no devuelve señales de validez ni de actividad.
La comprobación previa descarta las líneas mal formadas, por lo que nunca entran en el recuento facturable. De los números restantes, tampoco se cobran los que el servicio de origen no pueda resolver. Solo paga por los números que realmente devuelven un resultado.
Depende de la cantidad de números y del producto. Puede cerrar la página después de enviarla; la tarea se ejecuta en segundo plano y el resultado le espera en la página de verificación masiva.
Sí. Una tarea fallida se reembolsa íntegramente. Si la tarea se completa correctamente pero algunos números no devuelven nada, esa parte se reembolsa automáticamente. La diferencia entre el importe reservado y lo realmente cobrado siempre se devuelve.
Consulta de operador globalSuba un archivo completo de números: operador, operador subyacente, tipo de línea, país, región y ciudad de cada uno, los mismos campos que la consulta de operador en tiempo real.Actividad del númeroObtén una señal de actividad por número mediante una tarea de archivo asíncrona. Combina los resultados true/false con tus registros de interacción para revisar grupos y prioridades de seguimiento.Las verificaciones masivas y en tiempo real consumen el mismo saldo: no hay nada adicional que activar. Regístrese y suba su primer archivo en la página de verificación masiva.