Solicitud 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.txtProducto masivo carrier_batch
Consulta de operador global
Suba 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.
Un complemento para listas grandes completas: para unos pocos números, la verificación en tiempo real responde en la misma solicitud. Verificación en tiempo real →
Contrato de la API
Dos pasos: enviar el archivo y consultar la tarea
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.
1. Enviar el archivo
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.
Respuesta: tarea creada
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. Consultar la tarea
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.
Solicitud cURL
GET /api/v1/bulk-tasks/{id}curl "https://carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Respuesta: tarea finalizada
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"
}
}Cómo se ejecuta
Qué ocurre con una tarea masiva
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.
01Suba el archivo
Un archivo .txt o .csv con un número por línea. Se transmite directamente; no se escribe nada en disco.
02Comprobación previa y reserva
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.
03Ejecución en segundo plano
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.
04Descargue el resultado
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.
Campos del resultado
Columnas del archivo de resultados
La descarga es un único archivo CSV con la tabla de resultados completa.
Columnas del archivo de resultados
identifier·17253100591— El número enviado como dígitos sin formato con el código de país, sin signo más ni espacios (p. ej., 17253100591).carrier·T-Mobile— Operador al que se asignó originalmente el número. No es el operador actual tras una portabilidad.underlying_carrier— Operador subyacente indicado por el proveedor cuando difiere del asignado; vacío cuando el proveedor no lo facilita.number_type·Fixed Line or Mobile— Tipo de línea indicado por el proveedor, como Fixed Line or Mobile; vacío cuando no está disponible.country_code·US— Código ISO del país al que pertenece el número.region·CA— Región de asignación; vacío cuando el proveedor no la facilita.city·LOS ANGELES— Ciudad de asignación; vacío cuando el proveedor no la facilita.
Ideal para
Cuándo recurrir a este producto
Segmentación de listas
Organice una lista completa de números por operador original, tipo de línea y país o región de asignación en un archivo de resultados descargable.
Revisión de costes de enrutamiento
Use las columnas de operador y región para comparar registros internos de enrutamiento, compras o costes sin consultar los números uno a uno.
Higiene de la base de datos
Encuentre los registros de números a los que les falta el operador original, la región o la ciudad y cree una lista para completarlos y revisarlos manualmente. Separe los registros vacíos, incompletos e incoherentes para que no entren inadvertidamente en análisis posteriores.
Flujo de trabajo sugerido: marque los registros para revisión, exporte la lista para completar los datos y, después, vuelva a escribirla o repita la consulta.
Respuesta directa
¿Qué es la Consulta de operador global masiva?
La consulta de operador masiva es la versión por archivo de la consulta de operador en tiempo real, pensada para listas a partir de mil números: suba un archivo, la tarea se ejecuta en segundo plano y descargue un CSV de resultados con los mismos campos para cada número. Cada número debe incluir su código de país y todos los números de un archivo deben pertenecer al país que elija al subirlo; los números sin código de país o de otro país se excluyen y no se cobran.
Límites claros
Límites de este producto
- Describe la red a la que se asignó originalmente un número. No sigue la portabilidad numérica, por lo que no es necesariamente el operador que da servicio al número hoy.
- No es una comprobación de localizabilidad ni una verificación de identidad: no indica si el número está en servicio ni quién es su titular.
- No se envía nada a los números del archivo: la consulta se realiza sobre datos de asignación.
- Los resultados reflejan los datos de asignación en el momento en que se ejecutó la tarea, y los resultados almacenados nunca se actualizan automáticamente. Volver a ejecutar el archivo no revela los operadores a los que se portaron los números.
- Los enlaces de descarga caducan. Obtenga el archivo poco después de que termine la tarea; si un enlace caduca, vuelva a consultar la tarea para obtener uno nuevo.
Cuándo encaja el modo masivo
Cuándo merece la pena el modo masivo y cuándo es más rápido el tiempo real
| Verificación en tiempo real | Verificación masiva | |
|---|---|---|
| Cuántos números | 1 número por verificación individual; varios por solicitud múltiple: los límites exactos figuran en la documentación de la API | Una lista grande completa en una sola tarea: el intervalo de tamaño actual figura en la página de precios |
| Obtención de resultados | De inmediato: el endpoint individual y el múltiple responden en la misma respuesta; el panel los devuelve uno a uno | Descargue un archivo de resultados cuando termine la tarea |
| País | No hay que elegir: cada número lleva su propio código de país; puede mezclarlos libremente en una solicitud | Un país por tarea, seleccionado al subir el archivo y enviado con él |
| Formato del resultado | JSON, campos por número | Archivo de resultados (un CSV con la tabla completa) |
| Uso habitual | Enriquecimiento del CRM en el alta, consultas de agentes, reglas de enrutamiento | Segmentación de listas, revisión de costes de enrutamiento, higiene de la base de datos |
Preguntas frecuentes del producto
Acerca de Consulta de operador global
¿Cuándo debo usar el modo masivo en lugar de una verificación en tiempo real?
Use el modo masivo para una lista grande completa. Para unos pocos números, la verificación en tiempo real responde en la misma solicitud, sin ninguna tarea que programar.
¿Qué ocurre con los números no válidos del archivo?
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.
¿Cuánto tarda una tarea?
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.
¿Se me reembolsa si falla?
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.
Cree una cuenta para enviar una tarea masiva
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.