Ir al contenido
POST AI agent ready /v1/phone

API de validación de teléfono: analizador de números gratuito

Analiza y valida un número de teléfono. Devuelve versiones formateadas (E.164, nacional), código de país y nombre de país.

Parameters

stringrequired

Phone number to validate. Include the country code for best results.

string

ISO 3166-1 alpha-2 country code hint for parsing numbers without a country prefix.

Code examples

curl -X POST https://api.botoi.com/v1/phone \
  -H "Content-Type: application/json" \
  -d '{"phone":"+14155552671","country":"US"}'

When to use this API

Normalizar números de teléfono en una base de datos de contactos

Los usuarios ingresan números de teléfono en docenas de formatos: "415-555-2671", "(415) 555 2671", "+1 415.555.2671". Analice cada uno a través de este punto final para obtener el formato E.164 estandarizado para el almacenamiento. Utilice el formato_nacional para mostrarlo en la interfaz de usuario.

Enrutar mensajes SMS por país

Antes de enviar un SMS a través de tu proveedor de mensajería, valida el número de teléfono y extrae su código de país. Enrute mensajes a través de puertas de enlace de SMS específicas de la región para reducir costos y mejorar las tasas de entrega.

Bloquear números no válidos en formularios de registro

Valide los números de teléfono al enviar el formulario de registro. Rechace los números no válidos de inmediato y muestre a los usuarios el formato nacional como confirmación de lo que se analizó, detectando errores tipográficos antes de que lleguen a su base de datos.

Frequently asked questions

¿Qué formatos de números de teléfono se aceptan?
El terminal acepta el formato internacional (+14155552671), el formato nacional ((415) 555-2671) y las variaciones más comunes con guiones, puntos o espacios. Incluir el prefijo del código de país proporciona los resultados más precisos.
¿Cuándo debo utilizar el parámetro de país?
Utilice el parámetro de país cuando el número de teléfono no incluya un prefijo de código de país (por ejemplo, "4155552671" sin "+1"). La sugerencia de país le dice al analizador qué plan de numeración aplicar.
¿Qué es el formato E.164?
E.164 es el estándar internacional para números de teléfono. Comienza con un "+" seguido del código del país y el número de abonado, sin espacios ni puntuación. Ejemplo: +14155552671.
¿Esto verifica que el número de teléfono esté en servicio?
No. Este punto final valida el formato y la estructura únicamente. No llama ni envía mensajes de texto al número para verificar que esté activo.
¿Puedo validar números de teléfono fijo y móvil?
Sí. El analizador maneja formatos de números de teléfonos fijos y móviles. Valida en base a las reglas del plan de numeración del país.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs