FlowData

Como verifico um endereço de e-mail com o Email Verifier?

Publicado em 10. novembro 2026

O Email Verifier informa se você pode enviar e-mails para um endereço. Isso é útil em cadastros de newsletter, formulários de contato ou antes de usar uma lista antiga de endereços. Assim você evita devoluções e protege a reputação do seu domínio de envio.

A requisição

A verificação é um GET para /v1/email-verification/ com o endereço no final do caminho. A sua chave vai somente no cabeçalho Authorization, nunca na URL.

curl "https://api.flowdata.one/v1/email-verification/maria.silva%40example.com" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

Codifique o endereço para a URL, principalmente se ele tiver caracteres especiais. Um + na parte local, como em anna+newsletter@example.com, vira %2B, e o @ pode ser escrito como %40. A maioria das linguagens de programação tem uma função pronta para isso, como rawurlencode() em PHP. Domínios com acentos, como info@joão.example, são reconhecidos.

A resposta

{
  "email_address": "maria.silva@example.com",
  "status": "valid",
  "source": "LR",
  "result": "safe",
  "reason": "accepted",
  "checks": {
    "syntax": true,
    "mx": "ok",
    "mail_provider": "other",
    "disposable": false,
    "role_account": false,
    "catch_all": false
  }
}
  • email_address: o endereço verificado.
  • status: a resposta simples para a pergunta se você pode enviar: valid, risky, invalid, disposable ou unknown.
  • result: a avaliação mais detalhada: safe, risky, invalid ou unknown.
  • reason: o motivo do resultado, por exemplo accepted, catch_all ou rejected.
  • checks: as verificações individuais: sintaxe, servidor de e-mail, provedor de e-mail, domínio descartável, endereço de função e catch-all. Em resultados armazenados mais antigos, reason e checks podem ser null.
  • source: de onde vem o resultado. DB é um resultado armazenado, NA é a verificação própria do FlowData, e qualquer outro código indica o serviço de verificação conectado.

O significado dos valores e como lidar com eles estão em O que significam os resultados do Email Verifier e como lidar com eles?.

Quanto tempo leva uma verificação?

O FlowData verifica primeiro por conta própria: sintaxe, resultado armazenado, servidor de e-mail do domínio, domínios descartáveis e domínios catch-all conhecidos. Isso é rápido. Só quando não basta, ele consulta serviços de verificação conectados, um após o outro, até obter uma resposta clara. Isso pode levar alguns segundos e, no pior caso, mais de um minuto. Por isso, defina um tempo limite generoso na sua requisição e, em cadastros, verifique os endereços em segundo plano, e não enquanto a pessoa espera na página.

Se o endereço tiver um formato inválido

Endereços com formato inválido, por exemplo sem @, são recusados na hora com HTTP 400:

{"error":"Invalid email address"}

Já um domínio sem servidor de e-mail não é erro de formato. Esses endereços recebem HTTP 200 com "result": "invalid".

Quanto custa uma verificação?

A cobrança é por uso, com preço a cada 1.000 verificações bem-sucedidas. Um resultado armazenado também conta como verificação. Não são cobradas as requisições com resultado unknown, os endereços recusados com HTTP 400 nem as requisições que falham por outro motivo. Os valores estão na página de preços, e os preços que valem para a sua equipe ficam no FlowData em Cobrança.

Se o saldo não bastar ou um limite de gastos tiver sido atingido, a API responde com HTTP 402 e o código insufficient_quota ou spend_limit_exceeded. Sem uma chave válida, você recebe HTTP 401. Há mais informações em Erros e limites de requisições da API do FlowData.

Bom saber

Este artigo foi útil?

Voltar para Email Verifier