Documenti API di convalida delle e-mail

Come iniziare

Tutte le richieste API richiedono l'autenticazione tramite una chiave API. La chiave API è disponibile nella dashboard.

Intestazione: "x-api-key: your-api-key"

Verifica singola

Verificare la validità di un singolo indirizzo e-mail o di un dominio, lo stato "usa e getta", i servizi di privacy e la deliverability.

Punto finale

GET /v1/verify

Parametri

Nome	Tipo	Richiesto	Descrizione
input	string	Sì	Indirizzo e-mail o dominio da verificare (ad esempio, [email protected] o example.com)

Campi di risposta

Campo	Descrizione
valid	Indica se il formato dell'e-mail è corretto
block	Indica se l'email deve essere bloccata (vero se usa e getta, privacy, applePrivateEmail, deliverable o catch_all è vero)
disposable	Determina se l'indirizzo e-mail è temporaneo o usa e getta.
privacy	Determina se il server di posta utilizza un alias o un forwarder di posta elettronica.
applePrivateEmail	Indica se l'e-mail è un indirizzo e-mail privato Apple.
deliverable	Controlla se la casella di posta elettronica esiste e può ricevere e-mail.
domain	La parte del dominio dell'indirizzo e-mail
email_address	L'indirizzo e-mail
catch_all	Indica se il dominio ha una configurazione di email catch-all che accetta tutte le email in arrivo indipendentemente dall'indirizzo del destinatario.
mx_found	Indica se il dominio ha server di posta validi (record MX).
remaining_credits	Il numero di crediti API rimanenti nel vostro account

Lista nera/bianca: Solo il campo del blocco riflette l'appartenenza all'elenco. Lista nera → blocco: vero; lista bianca → blocco: falso; non in lista bianca (se abilitato) → blocco: vero. Non usare valid per decidere se bloccare in base agli elenchi.

Esempio di risposta

{
  "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
}

Esempi di codice

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

Provate

Chiave API

Per testare gli endpoint è necessaria una chiave API.

Indirizzo e-mail o dominio

Da provare con:

Verifica dei lotti

Verifica di più indirizzi e-mail o domini in un'unica richiesta (max 100 elementi).

Punto finale

POST /v1/verify/batch

Parametri

Nome	Tipo	Richiesto	Descrizione
inputs	array of strings	Sì	Serie di indirizzi e-mail o domini da verificare

Esempi di codice

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]"
    ]
  }'

Provate

Chiave API

Per testare gli endpoint è necessaria una chiave API.

Indirizzi e-mail o domini

Provate con domini diversi:

Controllo solo per la consegna

Controllo rapido della deliverability delle e-mail utilizzando la verifica MX e SMTP senza chiamate API esterne. Restituisce solo i campi relativi alla deliverability per tempi di risposta più rapidi.

Punto finale

GET /v1/verify/deliverable

Parametri

Nome	Tipo	Richiesto	Descrizione
input	string	Sì	Indirizzo e-mail per verificare la deliverability (ad esempio, [email protected]). L'input di solo dominio non è supportato per questo endpoint.

Campi di risposta

Campo	Descrizione
valid	Indica se il formato dell'e-mail è corretto
deliverable	Controlla se la casella di posta elettronica esiste e può ricevere e-mail.
mx_found	Indica se il dominio ha server di posta validi (record MX).
catch_all	Indica se il dominio ha una configurazione di email catch-all che accetta tutte le email in arrivo indipendentemente dall'indirizzo del destinatario.
email_address	L'indirizzo e-mail
remaining_credits	Il numero di crediti API rimanenti nel vostro account

Esempio di risposta

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

Esempi di codice

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

Provate

Chiave API

Per testare gli endpoint è necessaria una chiave API.

Indirizzo e-mail o dominio

Da provare con:

Whitelist e blacklist

Controlla quali e-mail e domini vengono bloccati con regole di blacklist e whitelist per utente. Queste liste impostano il campo block in ogni risposta di verifica.

{}

Il campo block

Ogni risposta di verifica include un campo block. Usalo per decidere se bloccare l'e-mail/dominio in base alle tue liste:

trueL'e-mail o il suo dominio è in blacklist → block: true. Aggiungere un dominio blocca tutte le e-mail su di esso.

trueLa whitelist è attiva ma l'e-mail/dominio non è presente → block: true.

falseLa whitelist è attiva e l'e-mail o il suo dominio è presente → block: false.

—Nessuna lista si applica → block segue il risultato normale della verifica.

Panoramica

✘

Blacklist

Blocca sempre e-mail o domini specifici. Ad esempio, aggiungere example.com alla blacklist fa sì che qualsiasi e-mail @example.com restituisca block: true, indipendentemente dal risultato della verifica.

✔

Whitelist

Consenti solo e-mail o domini specifici. Con whitelist attiva, solo le voci in lista hanno block: false; tutto il resto block: true. Ad esempio, aggiungere gmail.com consente qualsiasi @gmail.com, ma [email protected] sarebbe bloccato. Disattivata, la whitelist non ha effetto.

Puoi aggiungere un'e-mail completa ([email protected]) o un dominio (example.com). Aggiungere un dominio si applica a tutte le e-mail su quel dominio. Il maiuscolo/minuscolo non conta.

Come funziona

Ordine di valutazione

Prima la blacklist — Se l'e-mail o il suo dominio è in blacklist, il risultato è block: true. Non si applica altra logica delle liste.

Whitelist (se attiva) — Se e-mail/dominio è in whitelist → block: false. Altrimenti → block: true.

Whitelist disattivata — Si applicano solo blacklist e verifica normale.

La blacklist ha sempre la precedenza: un indirizzo in blacklist resta bloccato anche se è in whitelist.

Cosa viene controllato

Verifica e-mail: l'API controlla indirizzo completo e dominio contro entrambe le liste. Una corrispondenza applica la regola della lista.

Verifica dominio: solo il dominio viene controllato contro blacklist e (se attiva) whitelist.

Riferimento rapido

Whitelist attiva	In blacklist	In whitelist	valore di block
No	Sì	—	`true`
No	No	—	Normale
Sì	Sì	Qualsiasi	`true`
Sì	No	Sì	`false`
Sì	No	No	`true`

Endpoint API delle liste

Tutti gli endpoint delle liste richiedono l'header: X-API-Key: your-api-key

Blacklist

GET/v1/blacklist

Elenco voci blacklist

POST/v1/blacklist

Aggiungi e-mail o dominio · { "value": "..." }

DELETE/v1/blacklist

Rimuovi voce · value=...

Whitelist

GET/v1/whitelist

Elenco voci whitelist

POST/v1/whitelist

Aggiungi e-mail o dominio · { "value": "..." }

DELETE/v1/whitelist

Rimuovi voce · value=...

GET/v1/whitelist/enabled

Stato whitelist · { "enabled": boolean }

PUT/v1/whitelist/enabled

Attiva/disattiva whitelist · { "enabled": true | false }

Esempi di codice (cURL)

✘

Blacklist

GET/v1/blacklist

Elenco voci blacklist

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

POST/v1/blacklist

Aggiungi e-mail o dominio

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

Rimuovi voce

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

✔

Whitelist

GET/v1/whitelist

Elenco voci whitelist

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

POST/v1/whitelist

Aggiungi e-mail o dominio

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

Rimuovi voce

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

GET/v1/whitelist/enabled

Stato whitelist

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

PUT/v1/whitelist/enabled

Attiva/disattiva whitelist

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 valore

[email protected] — E-mail: formato valido, es. [email protected]
example.com — Dominio: formato valido, es. example.com

Valori non validi vengono rifiutati con 400. Le voci sono memorizzate normalizzate. I duplicati sono uniti in una sola voce.

Dove si applicano le liste

Le regole delle liste si applicano dopo la verifica. Le risposte di verifica e-mail (singola e batch) e dominio includono già blacklist e whitelist dell'utente nel campo block.

Server MCP (integrazione agente AI)

Integrate la verifica delle e-mail direttamente negli agenti AI come Cursor e Claude Desktop utilizzando il Model Context Protocol (MCP). L'assistente AI può verificare le e-mail, controllare i domini e convalidare la sintassi senza lasciare l'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.

Impostazione

Aggiungere la seguente configurazione al file di configurazione .cursor/mcp.json o Claude Desktop:

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

Strumenti disponibili

Strumento	Descrizione	Ingresso	Crediti
verify_email	Verifica completa delle e-mail, compresi i controlli di sintassi, MX, SMTP, usa e getta, privacy e deliverability.	{ email: string }	1
verify_domain	Verifica completa dei domini, compresi i record MX, usa e getta, privacy e rilevamento di catch-all	{ domain: string }	1
check_deliverability	Controllo rapido della sola deliverability tramite verifica MX e SMTP senza chiamate API esterne	{ email: string }	1
verify_batch	Verifica in batch per un massimo di 100 email o domini in un'unica richiesta	{ inputs: string[] }	1 per item
validate_email_syntax	Convalida rapida della sintassi locale rispetto all'RFC 5322 senza chiamate di rete	{ email: string }	0 (free)