Consultar el operador de un teléfono
Saber quién opera un número de teléfono, y si es móvil, fijo o VoIP, es una señal útil, pero no es algo que los dígitos revelen por sí solos, y no es lo que este endpoint devuelve.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
La detección real de operador y tipo de línea exige una consulta a un HLR con licencia (Home Location Register), la base de datos por red que registra en qué operador vive un número en este momento. Esa consulta HLR no está cableada aquí: este endpoint no devuelve nombre de operador, tipo de línea ni país. Para las comprobaciones de teléfono que sí funcionan hoy, use la validación de formato.
Por qué los dígitos no revelan el operador
Durante años, los primeros dígitos de un número correspondían a un solo operador, y bastaba una tabla de consulta. La portabilidad numérica acabó con eso: los abonados conservan su número al cambiar de red, así que un prefijo ya no le dice cuál es el operador actual. La única fuente autoritativa es el HLR del operador, una base de datos por red y con licencia, y por eso la detección precisa de operador y tipo de línea es un servicio con licencia y no algo que se pueda derivar del número solo. Adivinar a partir de una tabla de prefijos desactualizada produce respuestas seguras y equivocadas.
Qué devuelve este endpoint hoy
Este endpoint no realiza actualmente una consulta HLR. No devuelve nombre de operador, tipo de línea (móvil, fija o VoIP) ni país. Cablear la detección de operador en vivo exige un proveedor HLR con licencia, que no está conectado aquí, así que si su integración depende de datos de operador o tipo de línea, este endpoint no se los va a dar. Preferimos decirlo con claridad antes que devolver un operador adivinado en el que su lógica de enrutamiento o de fraude terminaría confiando.
Qué sí está disponible: validación de formato
Lo que funciona hoy es validar el formato de un número de teléfono: confirmar que tiene una estructura y longitud plausibles para su código de país, atrapando un dígito transpuesto o un número simplemente demasiado corto antes de que dependa de él. Es una capacidad aparte y funcional; no le dirá el operador ni el tipo de línea, pero detiene los números malformados en la puerta, y es el primer paso correcto antes de que cualquier número vaya a un servicio de operador con licencia.
Por qué importa el tipo de línea, y por qué necesita una fuente con licencia
La razón por la que los equipos quieren este dato es real: una línea fija no puede recibir un SMS, y un número VoIP es barato de aprovisionar y fácil de descartar, precisamente por lo que los equipos antifraude lo vigilan. Pero justo porque ese dato dirige decisiones de enrutamiento y riesgo, tiene que venir de un HLR autoritativo y no de una heurística. Aproximarlo cambiaría un SMS equivocado por un puntaje de fraude equivocado, peor que no tener respuesta, porque una respuesta equivocada es una sobre la que sus sistemas actúan con confianza.
Si necesita datos de operador
Si su caso de uso realmente requiere enrutamiento por operador o tipo de línea, necesita un feed HLR con licencia, que es una decisión de capacidad y no algo que este endpoint aproxime. Mientras tanto, valide el formato del número para que solo los números bien formados lleguen al servicio de operador que use, y trate la detección de operador y tipo de línea como un paso aparte que obtiene de un proveedor con licencia. El acceso al KIT funciona con saldo prepago, y una tarea fallida no se cobra.
Qué puede hacer con ella
Atrapar números malformados en el registro
Valide el formato de un número de teléfono en el registro para rechazar un número transpuesto o demasiado corto antes de guardarlo, con la validación de formato en vez de una consulta de operador.
Limpiar una lista de contactos
Revise una lista de contactos almacenada en busca de números que no sean estructuralmente válidos para su código de país, para que una campaña posterior no se construya sobre datos rotos.
Preparar números para una consulta de operador con licencia
Valide el formato primero para que solo los números bien formados se envíen a un servicio HLR de operador con licencia, evitando consultas desperdiciadas sobre entradas malformadas.
No condicionar el SMS a un operador adivinado
Como el tipo de línea no se devuelve aquí, no decida entre SMS y voz a partir de un operador adivinado; valide el formato y confirme la entregabilidad con el resultado de entrega de su proveedor de SMS.
Preguntas frecuentes
¿Qué devuelve una api consultar operador de un telefono aquí?
No devuelve nombre de operador, tipo de línea ni país, y no realiza una consulta HLR. Para una comprobación de teléfono que funcione, use la validación de formato, que confirma que un número es estructuralmente plausible para su país.
¿Puede decirme si un número es móvil o fijo?
No. La detección de tipo de línea —móvil, fija o VoIP— exige una consulta a un HLR con licencia, que este endpoint no realiza.
¿Es gratis usarla?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Uso esta o la validación de formato de teléfono?
Para cualquier cosa sobre la que pueda actuar hoy —atrapar números malformados— use la validación de formato. Este endpoint de operador no devuelve datos de operador ni tipo de línea, así que no puede dirigir decisiones de enrutamiento o de fraude por sí solo.
¿Por qué no estima el operador a partir del número?
Porque la portabilidad numérica hace de un prefijo una conjetura poco fiable: un abonado conserva su número entre operadores. Un operador equivocado es peor que ninguno para la lógica de enrutamiento y de fraude, así que este endpoint no lo aproxima.
¿Necesito validar el número primero?
Sí. Ejecute la validación de formato para confirmar que el número es estructuralmente correcto: esa es la comprobación que funciona. El detalle de operador y tipo de línea vendría de un servicio HLR con licencia aparte.
¿Cómo recibo el resultado?
Obtiene un task_id de inmediato, y la respuesta llega mediante su webhook firmado o un enlace firmado válido por 24 horas, tal como se resuelve cualquier tarea de esta API.
¿Se conserva el número enviado?
No. El número enviado y su resultado se eliminan al cerrar la ventana de retención y nunca se usan para entrenar modelos.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/verify/phone-carrier \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+34600123456"}'const res = await fetch("https://api.kit.forhosting.com/verify/phone-carrier", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"phone": "+34600123456"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/verify/phone-carrier",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"phone": "+34600123456"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/phone-carrier", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"phone":"+34600123456"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"phone":"+34600123456"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/phone-carrier", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"phone": "+34600123456"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "verify.phone_carrier",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |