> For the complete documentation index, see [llms.txt](https://docs-es.sinch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-es.sinch.com/enviar-un-mensaje/documentacion-tecnica-sms/api-validacion-de-numeros.md).

# API Validación de números

Esta API permite realizar consultas en lote de números retornando la operadora a la que esos números pertenecen y consecuentemente los números inválidos (si un número no pertenece a ninguna operadora por lo tanto es inválido). Ella utiliza el protocolo HTTP con TLS y el metodo POST con parámetros en [JSON](http://json.org/). La consulta permite saber si determinado número pertenece a la operadora pero no es posible verificar si este número se encuentra activo.

{% hint style="danger" %}
**IMPORTANTE: Las consultas de carrier lookup poseen una tarifacion diferenciada de los envíos de SMS, antes de realizar la consulta verifique con el responsable del equipo comercial sobre las tarifaciones**
{% endhint %}

#### Autenticacion <a href="#autenticacion" id="autenticacion"></a>

Para efectuar envíos y consultas en nuestra API es necesaria la autenticacion por medio de usuario o e-mail, en conjunto con un token.

| Campo               | Detalles                                                                                                                                                 | Data Type |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| UserName            | Su usuario o email                                                                                                                                       | String    |
| AuthenticationToken | Su token de autenticacion. Verifique [aqui](https://messaging.wavy.global/dashboard/profile/settings#profile) y lea las descripciones de usuarios abajo. | String    |

#### Detalles de conexión <a href="#detalles-de-conexi-n" id="detalles-de-conexi-n"></a>

|                   |                                     |
| ----------------- | ----------------------------------- |
| **Hostname**      | api-messaging.wavy.global           |
| **APIs**          | Consulta en lote /v1/carrier/lookup |
| **Puerta**        | 443 (https)                         |
| **Protocolo**     | HTTPS (encriptacion TLS)            |
| **Autenticacion** | username + token                    |
| **Portal**        | messaging.wavy.global               |