# Verificar dirección de correo (/es/api-reference/public-api/verifyEmail)

`POST /v1/verify`

Base URL: `https://api.bitelio.com`

Verifica una dirección de correo: comprueba su validez, si proviene de un dominio desechable o de un proveedor de correo personal, verifica los registros MX y detecta posibles errores tipográficos con sugerencias.

## Request body

- `email`: string (email) (required) — Dirección de correo a verificar

Example:

```json
{
  "email": "user@example.com"
}
```

## Responses

### `200` — Verificación de correo completada correctamente

- `success`: boolean — Siempre true en solicitudes exitosas
- `data`: object
  - `email`: string (email) (required) — Dirección de correo que fue verificada
  - `valid`: boolean (required) — Si el correo parece válido en general
  - `isDisposable`: boolean (required) — Si el correo proviene de un dominio desechable o temporal
  - `isAlias`: boolean (required) — Si el correo proviene de un servicio de reenvío o alias
  - `isTypo`: boolean (required) — Si se detectó un posible error tipográfico en la dirección de correo
  - `isPlusAddressed`: boolean (required) — Si el correo usa direccionamiento con signo más (contiene un + en la parte local)
  - `isPersonalEmail`: boolean (required) — Si el correo proviene de un proveedor de correo personal o gratuito (Gmail, Hotmail, Yahoo, etc.)
  - `domainExists`: boolean (required) — Si el dominio existe en el DNS (tiene registros NS)
  - `hasWebsite`: boolean (required) — Si el dominio tiene un sitio web (tiene registros DNS A o AAAA) - solo informativo
  - `hasMxRecords`: boolean (required) — Si el dominio tiene registros MX configurados para la entrega de correo
  - `suggestedEmail`: string (email) — Corrección sugerida si se detectó un error tipográfico (opcional)
  - `reasons`: array<string> (required) — Array de motivos legibles que describen los resultados de la verificación

```json
{
  "success": false,
  "data": {
    "email": "user@example.com",
    "valid": false,
    "isDisposable": false,
    "isAlias": false,
    "isTypo": false,
    "isPlusAddressed": false,
    "isPersonalEmail": false,
    "domainExists": false,
    "hasWebsite": false,
    "hasMxRecords": false,
    "reasons": [
      "string"
    ]
  }
}
```

### `400` — Solicitud incorrecta - formato de correo inválido

- `code`: integer
- `error`: string
- `message`: string
- `time`: integer

```json
{
  "code": 0,
  "error": "string",
  "message": "string",
  "time": 0
}
```

### `401` — No autorizado - clave de API inválida o ausente

- `code`: integer
- `error`: string
- `message`: string
- `time`: integer

```json
{
  "code": 0,
  "error": "string",
  "message": "string",
  "time": 0
}
```

## Example request

```bash
curl -X POST 'https://api.bitelio.com/v1/verify' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com"}'
```