VerifyMails

Referencia de la API

Base URL: https://www.verifymails.dev. Autentícate con Authorization: Bearer vm_live_... o ?key=vm_live_...

Endpoints

GET/api/v1/verify?email={email}Verificar una dirección de email
GET/api/v1/domain?domain={domain}Comprobación a nivel de dominio (servidor de correo, proveedor)

Respuesta — /api/v1/verify

{
  "email": "[email protected]",
  "domain": "gmail.com",
  "disposable": false,          // disposable / temporary email
  "block": false,               // recommended to block (disposable or high risk)
  "deliverable_email": true,    // domain can receive mail
  "mx": true,
  "mx_host": ["gmail-smtp-in.l.google.com", "..."],
  "mx_priority": { "gmail-smtp-in.l.google.com": 5 },
  "email_provider": "Gmail",
  "privacy": false,             // alias / privacy relay / forwarding
  "privacy_provider": null,
  "apple_hide_my_email": false,
  "catch_all": null,            // true / false / null (not probed yet)
  "risk_score": 0,              // 0-100
  "canonical": "[email protected]",   // normalized (dots / +tag removed)
  "is_variant": true,
  "plus_tag": "tag",
  "domain_age_days": 10759,
  "authentication": { "spf": {...}, "dmarc": {...} },
  "signals": [...]
}

Errores

EstadoSignificado
400Email / dominio inválido
401API key ausente o inválida
402Límite diario agotado
429Límite de tasa superado (ver Retry-After)

Límites y cuotas

Planes de pago: 2 peticiones/segundo para emails, 15 peticiones/segundo para dominios (gratis: 1/s y 3/s). Las cuotas son diarias: 5.000 / 10.000 / 20.000 consultas al día en Basic / Premium / Pro.

Campos según el plan

La respuesta anterior corresponde al plan Pro. Los campos solo se incluyen si tu plan cubre la función; un campo ausente = no está en tu plan (nunca se rellena con null):

PlanCampos
Basicemail, domain, disposable, block, risk_score
Premium+ privacy, privacy_provider, mx, mx_host, mx_priority, authentication, domain_age_days, signals, related_domains (domain endpoint)
Pro+ email_provider, provider_category, apple_hide_my_email, canonical, is_variant, plus_tag, catch_all, deliverable_email