# 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               |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-es.sinch.com/enviar-un-mensaje/documentacion-tecnica-sms/api-validacion-de-numeros.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.