Verificação Única

O endpoint de verificação única permite validar um endereço de email por requisição. Ideal para validação em tempo real em formulários de cadastro, checkout ou qualquer fluxo onde o email é coletado individualmente.

Endpoint

POST https://mail.flowsales.online/api/v1/verify

Requisição

Envie um JSON com o campo email contendo o endereço a ser verificado.

Headers obrigatórios

Header	Valor
`Authorization`	`Bearer {API_KEY}`
`Content-Type`	`application/json`
`Accept`	`application/json`

Body

JSON

{
  "email": "usuario@exemplo.com"
}

Campo	Tipo	Obrigatório	Descrição
`email`	string	Sim	Endereço de email a ser verificado.

Exemplo de Requisição

cURL

curl -X POST https://mail.flowsales.online/api/v1/verify \
  -H "Authorization: Bearer fm_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"email": "joao.silva@empresa.com.br"}'

Resposta

A resposta contém o resultado completo da verificação, incluindo o veredito, score, verificações individuais e detalhes do domínio.

JSON — 200 OK

{
  "email": "joao.silva@empresa.com.br",
  "verdict": "deliverable",
  "score": 95,
  "checks": {
    "syntax": true,
    "mx_records": true,
    "smtp_valid": true,
    "deliverable": true
  },
  "details": {
    "domain": "empresa.com.br",
    "username": "joao.silva",
    "free": false,
    "disposable": false,
    "role_account": false,
    "catch_all": false,
    "mx_host": "mx1.empresa.com.br",
    "suggestion": null
  },
  "meta": {
    "cached": false,
    "latency_ms": 287,
    "verified_at": "2026-03-01T14:30:00Z"
  }
}

Campos da resposta

Campo	Tipo	Descrição
`email`	string	O endereço de email verificado (normalizado para minúsculas).
`verdict`	string	Veredito final: `deliverable`, `undeliverable`, `risky` ou `unknown`.
`score`	integer	Pontuação de confiabilidade de 0 a 100.
`checks`	object	Resultado individual de cada verificação (syntax, mx_records, smtp_valid, deliverable).
`details`	object	Informações detalhadas sobre o domínio e o endereço (free, disposable, role_account, etc.).
`meta.cached`	boolean	Indica se o resultado veio do cache (`true`) ou foi verificado em tempo real (`false`).
`meta.latency_ms`	integer	Tempo de processamento da verificação em milissegundos.
`meta.verified_at`	string	Data e hora da verificação em formato ISO 8601 (UTC).

Exemplos por Veredito

deliverable

Email válido e seguro para envio.

JSON

{
  "email": "joao@gmail.com",
  "verdict": "deliverable",
  "score": 98,
  "checks": { "syntax": true, "mx_records": true, "smtp_valid": true, "deliverable": true },
  "details": { "domain": "gmail.com", "username": "joao", "free": true, "disposable": false, "role_account": false, "catch_all": false, "mx_host": "gmail-smtp-in.l.google.com", "suggestion": null }
}

undeliverable

Email inexistente ou domínio sem servidor de email.

JSON

{
  "email": "naoexiste@dominiofalso.xyz",
  "verdict": "undeliverable",
  "score": 5,
  "checks": { "syntax": true, "mx_records": false, "smtp_valid": false, "deliverable": false },
  "details": { "domain": "dominiofalso.xyz", "username": "naoexiste", "free": false, "disposable": false, "role_account": false, "catch_all": false, "mx_host": null, "suggestion": null }
}

risky

Email existe, mas apresenta sinais de risco (descartável, role account ou catch-all).

JSON

{
  "email": "test@tempmail.org",
  "verdict": "risky",
  "score": 25,
  "checks": { "syntax": true, "mx_records": true, "smtp_valid": true, "deliverable": true },
  "details": { "domain": "tempmail.org", "username": "test", "free": true, "disposable": true, "role_account": false, "catch_all": true, "mx_host": "mx.tempmail.org", "suggestion": null }
}

unknown

Não foi possível determinar o status com certeza. O servidor pode estar temporariamente indisponível.

JSON

{
  "email": "usuario@servidorlento.com",
  "verdict": "unknown",
  "score": 40,
  "checks": { "syntax": true, "mx_records": true, "smtp_valid": false, "deliverable": false },
  "details": { "domain": "servidorlento.com", "username": "usuario", "free": false, "disposable": false, "role_account": false, "catch_all": false, "mx_host": "mx.servidorlento.com", "suggestion": null }
}

Erros de Validação

JSON — 422 Unprocessable Entity

{
  "error": {
    "code": "validation_error",
    "message": "O campo email é obrigatório e deve ser um endereço válido.",
    "details": {
      "email": ["O campo email é obrigatório."]
    }
  }
}