Documentos da API de validação de e-mail

Começar a trabalhar

Todos os pedidos de API requerem autenticação utilizando uma chave de API. Pode encontrar a sua chave de API no painel de controlo.

Cabeçalho: "x-api-key: your-api-key"

Verificação única

Verificar a validade, o estado descartável, os serviços de privacidade e a capacidade de entrega de um único endereço de correio eletrónico ou domínio.

Ponto final

GET /v1/verify

Parâmetros

Nome	Tipo	Necessário	Descrição
input	string	Sim	Endereço de correio eletrónico ou domínio a verificar (por exemplo, [email protected] ou example.com)

Campos de resposta

Campo	Descrição
valid	Indica se o formato do correio eletrónico está correto
block	Indica se o correio eletrónico deve ser bloqueado (verdadeiro se descartável, privacidade, applePrivateEmail, entregável ou catch_all for verdadeiro)
disposable	Determina se o endereço de correio eletrónico é temporário ou descartável
privacy	Determina se o servidor de correio eletrónico está a utilizar um alias ou reencaminhador de correio eletrónico
applePrivateEmail	Indica se o correio eletrónico é um endereço de correio eletrónico Apple Private
deliverable	Verifica se a caixa de correio existe e se pode receber mensagens de correio eletrónico
domain	A parte do domínio do endereço de correio eletrónico
email_address	O endereço de correio eletrónico
catch_all	Indica se o domínio tem uma configuração de correio eletrónico abrangente que aceita todas as mensagens de correio eletrónico recebidas, independentemente do endereço do destinatário
mx_found	Indica se o domínio tem servidores de correio válidos (registos MX)
remaining_credits	O número de créditos API restantes na sua conta

Lista negra / Lista branca: Apenas o campo de bloqueio reflecte a pertença à lista. Lista negra → bloquear: verdadeiro; lista branca → bloquear: falso; não está na lista branca (quando activada) → bloquear: verdadeiro. Não utilizar valid para decidir se se deve bloquear com base em listas.

Exemplo de resposta

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Exemplos de códigos

curl "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

Experimentar

Chave API

É necessária uma chave de API para testar os pontos de extremidade.

Endereço de correio ou domínio

Experimentar com:

Verificação de lotes

Verificar vários endereços de correio eletrónico ou domínios num único pedido (máximo de 100 itens).

Ponto final

POST /v1/verify/batch

Parâmetros

Nome	Tipo	Necessário	Descrição
inputs	array of strings	Sim	Conjunto de endereços de correio eletrónico ou domínios a verificar

Exemplos de códigos

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "[email protected]",
      "[email protected]"
    ]
  }'

Experimentar

Chave API

É necessária uma chave de API para testar os pontos de extremidade.

Endereços de correio ou domínios

Experimente com domínios diferentes:

Verificação de entrega única

Verificação rápida da capacidade de entrega de correio eletrónico utilizando a verificação MX e SMTP sem chamadas de API externas. Devolve apenas campos relacionados com a capacidade de entrega para tempos de resposta mais rápidos.

Ponto final

GET /v1/verify/deliverable

Parâmetros

Nome	Tipo	Necessário	Descrição
input	string	Sim	Endereço de correio eletrónico para verificar a capacidade de entrega (por exemplo, [email protected]). A entrada apenas de domínio não é suportada para este ponto final.

Campos de resposta

Campo	Descrição
valid	Indica se o formato do correio eletrónico está correto
deliverable	Verifica se a caixa de correio existe e se pode receber mensagens de correio eletrónico
mx_found	Indica se o domínio tem servidores de correio válidos (registos MX)
catch_all	Indica se o domínio tem uma configuração de correio eletrónico abrangente que aceita todas as mensagens de correio eletrónico recebidas, independentemente do endereço do destinatário
email_address	O endereço de correio eletrónico
remaining_credits	O número de créditos API restantes na sua conta

Exemplo de resposta

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "[email protected]",
  "remaining_credits": 99
}

Exemplos de códigos

curl "https://api.verify-email.app/v1/verify/[email protected]" \
  -H "X-API-Key: your-api-key"

Experimentar

Chave API

É necessária uma chave de API para testar os pontos de extremidade.

Endereço de correio ou domínio

Experimentar com:

Lista branca e lista negra

Controle que e-mails e domínios são bloqueados com regras de lista negra e branca por utilizador. Estas listas definem o campo block em cada resposta de verificação.

{}

O campo block

Cada resposta de verificação inclui um campo block. Use este campo para decidir se deve bloquear o e-mail/domínio com base nas suas listas:

trueO e-mail ou o seu domínio está na lista negra → block: true. Adicionar um domínio bloqueia todos os e-mails nesse domínio.

trueA lista branca está ativa mas o e-mail/domínio não está nela → block: true.

falseA lista branca está ativa e o e-mail ou o seu domínio está nela → block: false.

—Nenhuma lista se aplica → block segue o resultado normal da verificação.

Visão geral

✘

Lista negra

Bloquear sempre e-mails ou domínios específicos. Por exemplo, adicionar example.com à lista negra faz com que qualquer e-mail @example.com devolva block: true, independentemente do resultado da verificação.

✔

Lista branca

Permitir apenas e-mails ou domínios específicos. Com a lista branca ativa, só as entradas da lista têm block: false; todo o resto tem block: true. Por exemplo, adicionar gmail.com permite qualquer @gmail.com, mas [email protected] seria bloqueado. Desativada, a lista branca não tem efeito.

Pode adicionar um e-mail completo ([email protected]) ou um domínio (example.com). Adicionar um domínio aplica-se a todos os e-mails nesse domínio. Não se distingue maiúsculas de minúsculas.

Como funciona

Ordem de avaliação

Primeiro a lista negra — Se o e-mail ou o seu domínio está na lista negra, o resultado é block: true. Não se aplica mais lógica de listas.

Lista branca (se ativa) — Se o e-mail/domínio está na lista branca → block: false. Caso contrário → block: true.

Lista branca desativada — Aplicam-se apenas a lista negra e a verificação normal.

A lista negra tem sempre prioridade: um endereço na lista negra permanece bloqueado mesmo que esteja também na branca.

O que é verificado

Verificação de e-mail — a API verifica o endereço completo e o domínio contra ambas as listas. Qualquer correspondência aplica a regra da lista.

Verificação de domínio — apenas o domínio é verificado contra a lista negra e (se ativa) a branca.

Referência rápida

Lista branca ativa	Na lista negra	Na lista branca	valor de block
Não	Sim	—	`true`
Não	Não	—	Normal
Sim	Sim	Qualquer	`true`
Sim	Não	Sim	`false`
Sim	Não	Não	`true`

Endpoints de listas da API

Todos os endpoints de listas requerem o cabeçalho: X-API-Key: your-api-key

Lista negra

GET/v1/blacklist

Listar entradas da lista negra

POST/v1/blacklist

Adicionar e-mail ou domínio · { "value": "..." }

DELETE/v1/blacklist

Remover entrada · value=...

Lista branca

GET/v1/whitelist

Listar entradas da lista branca

POST/v1/whitelist

Adicionar e-mail ou domínio · { "value": "..." }

DELETE/v1/whitelist

Remover entrada · value=...

GET/v1/whitelist/enabled

Obter estado da lista branca · { "enabled": boolean }

PUT/v1/whitelist/enabled

Ativar/desativar lista branca · { "enabled": true | false }

Exemplos de códigos (cURL)

✘

Lista negra

GET/v1/blacklist

Listar entradas da lista negra

curl "https://api.verify-email.app/v1/blacklist" \
  -H "X-API-Key: your-api-key"

POST/v1/blacklist

Adicionar e-mail ou domínio

curl -X POST "https://api.verify-email.app/v1/blacklist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/blacklist

Remover entrada

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

✔

Lista branca

GET/v1/whitelist

Listar entradas da lista branca

curl "https://api.verify-email.app/v1/whitelist" \
  -H "X-API-Key: your-api-key"

POST/v1/whitelist

Adicionar e-mail ou domínio

curl -X POST "https://api.verify-email.app/v1/whitelist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/whitelist

Remover entrada

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

GET/v1/whitelist/enabled

Obter estado da lista branca

curl "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "X-API-Key: your-api-key"

PUT/v1/whitelist/enabled

Ativar/desativar lista branca

curl -X PUT "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "enabled": true
  }'

Formato do valor

[email protected] — E-mail: formato válido, ex. [email protected]
example.com — Domínio: formato válido, ex. example.com

Valores inválidos são rejeitados com 400. As entradas são armazenadas normalizadas. Duplicados são fundidos numa única entrada.

Onde as listas são aplicadas

As regras das listas são aplicadas após a verificação. As respostas de verificação de e-mail (única e em lote) e de domínio já incluem a lista negra e branca do utilizador no campo block.

Servidor MCP (integração de agentes de IA)

Integre a verificação de correio eletrónico diretamente em agentes de IA como o Cursor e o Claude Desktop utilizando o Protocolo de Contexto de Modelo (MCP). O seu assistente de IA pode verificar e-mails, verificar domínios e validar a sintaxe sem sair do editor.

Docs endpoint for AI agents

The API exposes a machine-readable docs endpoint (no API key required) so AI agents and MCP clients can discover the server, available tools, and auth requirements. Use this URL in your agent or MCP configuration.

GET /v1/mcp/docs

Returns JSON with server name, description, serverUrl, docsEndpoint, authentication details, and full tool definitions.

curl "https://api.verify-email.app/v1/mcp/docs"

AI agents can GET this URL to receive server metadata, tool schemas, and integration instructions in JSON. No authentication is required for the docs endpoint.

Open docs endpoint How to add in Cursor How to add in Claude

Integration details

Authentication

All MCP tool calls require your API key in the X-API-Key header. Get your key from the dashboard.

MCP server URL: https://api.verify-email.app/mcp

Docs endpoint (for agents): https://api.verify-email.app/v1/mcp/docs

Cursor

Add the server in Cursor Settings → Tools & MCP, or add the config to .cursor/mcp.json in your project or home directory.

Claude Desktop

Add the server to your Claude Desktop config (mcpServers in claude_desktop_config.json). Use the server URL and X-API-Key header as shown below.

Response format

Tool results match the REST API response shape (valid, block, deliverable, remaining_credits, etc.). Use the block field for blacklist/whitelist decisions.

This MCP server is production-ready and uses the same API as the REST endpoints. Credits are consumed per verification as with the REST API.

Configuração

Adicione a seguinte configuração ao seu ficheiro de configuração .cursor/mcp.json ou Claude Desktop:

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Ferramentas disponíveis

Ferramenta	Descrição	Entrada	Créditos
verify_email	Verificação completa do correio eletrónico, incluindo verificações de sintaxe, MX, SMTP, descartável, privacidade e capacidade de entrega	{ email: string }	1
verify_domain	Verificação completa do domínio, incluindo registos MX, descartáveis, privacidade e deteção de "catch-all	{ domain: string }	1
check_deliverability	Verificação rápida apenas da capacidade de entrega utilizando a verificação MX e SMTP sem chamadas externas à API	{ email: string }	1
verify_batch	Verificação em lote de até 100 e-mails ou domínios num único pedido	{ inputs: string[] }	1 per item
validate_email_syntax	Validação rápida da sintaxe local em relação ao RFC 5322 sem chamadas de rede	{ email: string }	0 (free)