IPScanner

Agentscan

Comprobación de email

Comprueba una dirección antes de aceptar un registro: sintaxis, dominios desechables, servidores de correo, erratas y direcciones de rol.

Comprobar una dirección de email

POST/v1/email/check
Clave de API1 petición

Parámetros

  • emailstringObligatorio

    La dirección a comprobar, 320 bytes como máximo. GET la toma como ?email=.

Campos de la respuesta

  • emailstring

    La dirección comprobada, con el dominio en minúsculas.

  • statusstring

    valid, invalid, risky o unknown.

  • reasonstring | null

    Por qué: syntax, no_mx, null_mx, disposable, typo, role, dns_error o quota. null si es valid.

  • suggestionstring | null

    La dirección con el dominio de webmail corregido, cuando el dominio parece una errata de uno.

  • domainstring

    El dominio en ASCII (IDN convertido).

  • checksobject

    Cada comprobación detrás del estado.

  • checks.mxboolean | null

    El dominio recibe correo. null si no se consultó el DNS o no respondió.

  • checks.disposableboolean

    El dominio da buzones desechables.

  • checks.roleboolean

    Un buzón compartido como info@ o support@.

  • checks.freeProviderboolean

    Un webmail gratuito como Gmail u Outlook.

  • mailboxstring

    Siempre not_checked: no se sondea el buzón.

curl -X POST https://ipscanner.io/v1/email/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@outlok.com"}'
Respuesta
{
  "email": "jane@outlok.com",
  "status": "risky",
  "reason": "typo",
  "suggestion": "jane@outlook.com",
  "domain": "outlok.com",
  "checks": {
    "syntax": true,
    "mx": true,
    "disposable": false,
    "role": false,
    "freeProvider": false
  },
  "mailbox": "not_checked"
}