Documentação FlowMail

API de validação de email em tempo real.

Início Rápido

2. Gere uma API key no dashboard

3. Faça sua primeira requisição:

cURL

curl -X POST https://mail.flowsales.online/api/v1/verify \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "teste@exemplo.com"}'

Resposta

{
  "email": "teste@exemplo.com",
  "verdict": "deliverable",
  "score": 95,
  "checks": {
    "syntax": true,
    "mx_records": true,
    "smtp_valid": true,
    "deliverable": true
  },
  "details": {
    "domain": "exemplo.com",
    "free": false,
    "disposable": false,
    "role_account": false,
    "catch_all": false
  },
  "cached": false,
  "latency_ms": 342,
  "verified_at": "2026-03-01T12:00:00Z"
}

Vereditos

Veredito	Score	Descrição
deliverable	80-100	Email existe e aceita mensagens
undeliverable	0-20	Email não existe ou rejeita mensagens
risky	20-70	Email existe mas pode ter problemas (descartável, role account)
unknown	30-50	Não foi possível determinar o status

Verificação em Lote

curl -X POST https://mail.flowsales.online/api/v1/verify/batch \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["a@ex.com", "b@ex.com", "c@ex.com"]}'

Máximo de 50 emails por requisição batch.

Autenticação

Todas as requisições devem incluir o header Authorization: Bearer SUA_API_KEY. Gere suas chaves no painel de API Keys.

Rate Limits

Cada plano tem um limite de requisições por segundo. Os headers X-RateLimit-Limit e X-RateLimit-Remaining são incluídos em toda resposta.

Plano	Limite
Free	2/s
Starter	10/s
Pro	30/s
Enterprise	100/s