## URL de la API
URL a la que se envían las solicitudes HTTP:
```url
https://portal.bulkgate.com/api/1.0/integration/check-phone-numbers
```

> [!NOTE]
> Si la solicitud no llega a su destino, repítala en el [servidor de respaldo](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/servidor-de-respaldo/) `backup1.bulkgate.com`.

```http
POST /api/1.0/integration/check-phone-numbers HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
```

### Tabla de parámetros

| NOMBRE DEL PARÁMETRO    | VALOR                                                                  | OBLIGATORIO | VALOR PREDETERMINADO |
|:------------------|:-----------------------------------------------------------------------|:---------:|:-------------:|
| application_id    | [ID de la aplicación](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/administracion-api/)                          |  **Sí**  |       -       | 
| application_token | [Token de autenticación de la aplicación](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/tokens-de-api/)                |  **Sí**  |       -       |
| numbers           | Lista de estructuras de números de teléfono que se van a comprobar, consulte [Números](#numeros) |    No     |       -       |

#### Números

| NOMBRE DEL PARÁMETRO | VALOR                                                                                                                | OBLIGATORIO |           VALOR PREDETERMINADO           |
|:---------------|:---------------------------------------------------------------------------------------------------------------------|:---------:|:---------------------------------:|
| phone_number   | Número de teléfono                                                                                                         | **Sí**   |                 -                 |
| country        | [Código de país](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) del número de teléfono    |   No      |                 -                 |



**Ejemplo de solicitud completa:**
```http-json
POST /api/1.0/integration/check-phone-numbers HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "numbers": [
        {
            "phone_number": "420777777777",
            "country": "cz"
        },
        {
            "phone_number": "7777",
            "country": "cz"
        }
    ]
}
```


## La respuesta a esta solicitud puede ser:

**En caso de éxito**
```json
{
    "data": {
        "420777777777": {
            "phone_number": "420777777777",
            "valid": true,
            "country": "cz",
            "call_prefix": 420,
            "network_code": "23003",
            "network_name": "Vodafone"
        },
        "7777": {
            "phone_number": "7777",
            "valid": false,
            "country": null,
            "call_prefix": null,
            "network_code": null,
            "network_name": "unknown"
        }
    }
}
```