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, test@example.com 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": "test@example.com",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Esempi di codice

curl "https://api.verify-email.app/v1/verify?input=test@example.com" \
  -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": [
      "test1@example.com",
      "test2@example.com"
    ]
  }'

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, test@example.com). 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": "test@example.com",
  "remaining_credits": 99
}

Esempi di codice

curl "https://api.verify-email.app/v1/verify/deliverable?input=test@example.com" \
  -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 user@yahoo.com sarebbe bloccato. Disattivata, la whitelist non ha effetto.

Puoi aggiungere un'e-mail completa (user@example.com) 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 }

Formato valore

user@example.com — E-mail: formato valido, es. user@example.com
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.

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)