API Números Telefónicos
Valida y obtén información sobre números telefónicos mexicanos con base de datos IFT actualizada.
Se requiere una API key para usar esta API. Fuente oficial IFT.
Regístrate para ComenzarCaracterísticas
✓ Validación y Formato
Valida formato de números mexicanos y estandariza a formato E.164 internacional.
✓ Identificación de Operador
Identifica el operador de telefonía (Telcel, AT&T, Movistar, etc.) usando base IFT.
✓ Base de Datos IFT
Información oficial del Instituto Federal de Telecomunicaciones actualizada regularmente.
✓ Tipo de Número
Clasifica números como móvil, fijo, gratuito (800), o especial.
Endpoint API
GET https://api.tlaloc.sh/mx/v1/phone?number={numero}
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
number |
string | Sí | Número telefónico (10 dígitos) |
Ejemplo de Solicitud
curl -X GET "https://api.tlaloc.sh/mx/v1/phone?number=8112345678"
Ejemplo de Respuesta
[
{
"clave_censal": "190390001",
"poblacion": "MONTERREY",
"municipio": "MONTERREY",
"estado": "NUEVO LEÓN",
"region": 2,
"nir": 81,
"serie": 1234,
"asl": 4,
"tipo_red": "MOVIL",
"modalidad": "MPP",
"razon_social": "RADIOMOVIL DIPSA SA DE CV",
"numeracion_inicial": "8112345000",
"numeracion_final": "8112345999",
"ocupacion": 1000,
"fecha_asignacion": "2021-03-10",
"fecha_consolidacion": null,
"fecha_migracion": null,
"presuscripcion": null,
"nir_anterior": null
}
]
Casos de Uso
Verificación de Usuarios
Valida números durante registro con códigos SMS.
Call Centers
Identifica operador para optimizar costos de llamadas.
Marketing por SMS
Valida números antes de enviar campañas de SMS masivo.
Prevención de Fraude
Detecta números inválidos o sospechosos en transacciones.
Preguntas Frecuentes
¿Qué información devuelve la API por número telefónico?
Los datos del Plan Nacional de Numeración del IFT: operador (razón social), tipo de red (fija o móvil), modalidad, población, municipio y estado de la serie, NIR, y fechas de asignación y migración de la numeración.
¿Distingue entre números fijos y móviles?
Sí, el campo tipo_red indica si la serie es fija o móvil — útil para decidir entre SMS y llamada, o para filtrar números que no pueden recibir mensajes.
¿De dónde salen los datos?
Del catálogo oficial de numeración del Instituto Federal de Telecomunicaciones (IFT), actualizado conforme el instituto publica cambios.
¿Cuánto cuesta?
$0.01 MXN (0.01 unidades) por consulta, IVA incluido — pensada para limpiar bases de datos completas sin que el costo sea un factor.
¿Para qué se usa normalmente esta API?
Depurar bases para campañas de SMS y llamadas, identificar el operador antes de enrutar tráfico, detectar números con formato válido pero serie inexistente, y segmentar contactos por región.