API de WhatsApp y CRM
POST/numbers/validate

Validar números

Endpoint útil para validar y normalizar una lista de números de teléfono, anteponiendo opcionalmente un código de llamada del país (prefix) a los números escritos sin +.

API de WhatsApp y CRM
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
POST https://api.getincloud.ai/v1/numbers/validate

Endpoint útil para validar y normalizar una lista de números de teléfono, anteponiendo opcionalmente un código de llamada del país (prefix) a los números escritos sin +.

La validación se realiza únicamente a nivel de formato de dígitos; no valida si un número de teléfono determinado existe en WhatsApp.

Para validar la existencia de un número en WhatsApp, consulta el endpoint de la API [Numbers/Exists](#operation/verifyNumber).

Prueba este endpoint en el probador de API en vivo%20555-0198%22%0A%20%20%20%20%7D%0A%20%20%5D%0A%7D)

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

CampoTipoObligatorioDescripción
countrystringNoCódigo de país opcional de los números de la lista. Ej.: US, GB, IT, FR, DE. No cambia cómo se leen los números: para leer los escritos sin + como números de un país, envía su código de llamada como prefix. minLength: 2 · maxLength: 2
prefixnumberNoCódigo de llamada del país opcional, como valor numérico, que se antepone a cada número de la lista que no empiece por +. Ej.: 1, 2, 33, 44, 36... minimum: 1 · maximum: 9999 · format: float
numbersarray<object>SíLista de números de teléfono que se van a validar y normalizar. Debe proporcionarse al menos un elemento.

Respuestas

CódigoDescripción
200Resultados de la validación
400Solicitud incorrecta
401No autorizado
403Faltan los permisos requeridos
404Recurso no encontrado
409Conflicto
429Demasiadas solicitudes
500Error inesperado
501No implementado
503Servicio no disponible
// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Validates and normalizes a list of phone numbers, reading the ones without + as US numbers
curl --request POST \
  --url https://api.getincloud.ai/v1/numbers/validate \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"prefix":1,"numbers":[{"phone":"415-555-0142"},{"phone":"+1 415 555 0142"},{"phone":"(212) 555-0198"}]}'


// Validates and normalizes a list of phone numbers with explicit country prefix
curl --request POST \
  --url https://api.getincloud.ai/v1/numbers/validate \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"numbers":[{"phone":"+1 415-555-0142"},{"phone":"+1 (212) 555-0198"},{"phone":"+1 646 555 0176"}]}'


// Validates and normalizes a list of phone numbers with international prefix
curl --request POST \
  --url https://api.getincloud.ai/v1/numbers/validate \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"prefix":1,"numbers":[{"phone":"415-555-0142"},{"phone":"212 (555) 0198"},{"phone":"6465550176"}]}'
AnteriorValidar nombre de usuarioSiguienteValidar números (alias de Validate)
¿Te sirvió esta página?