VerifyMails

Referência da API

Base URL: https://www.verifymails.dev. Autentique-se com Authorization: Bearer vm_live_... ou ?key=vm_live_...

Endpoints

GET/api/v1/verify?email={email}Verificar um endereço de e-mail
GET/api/v1/domain?domain={domain}Verificação em nível de domínio (servidor de e-mail, provedor)

Resposta — /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": [...]
}

Erros

StatusSignificado
400E-mail / domínio inválido
401API key ausente ou inválida
402Limite diário esgotado
429Limite de taxa excedido (ver Retry-After)

Limites e cotas

Planos pagos: 2 requisições/segundo para e-mails, 15 requisições/segundo para domínios (grátis: 1/s e 3/s). As cotas são diárias: 5.000 / 10.000 / 20.000 consultas por dia no Basic / Premium / Pro.

Campos por plano

A resposta acima corresponde ao plano Pro. Os campos só são incluídos quando seu plano cobre o recurso — campo ausente = fora do seu plano (nunca preenchido com null):

PlanoCampos
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