Verifica email REST per sviluppatori

API verifica email: un esito chiaro per ogni indirizzo, in tempo reale

Una richiesta GET esegue tutti e 9 i controlli e restituisce un esito strutturato in JSON, da collegare a moduli, CRM e agenti AI. Prova qui sotto lo stesso motore con un indirizzo qualsiasi.

1.000 crediti gratis alla registrazione, 2.500 con un'email aziendale. Senza carta.

Come funziona

Una chiamata, un esito completo

Tre passaggi, zero codice di integrazione. Invii l'indirizzo, il motore esegue nove controlli, leggi un esito strutturato su cui il tuo codice può decidere.

001RICHIESTA

Invia una richiesta

Passa l'indirizzo a /v1/email-validation con l'header X-API-Key: con una GET nell'URL o con una POST nel corpo. Niente SDK e niente OAuth, solo una chiamata autenticata.

002MOTORE

9 controlli in parallelo

Sintassi, DNS e record MX, handshake SMTP in tempo reale, rilevamento catch-all e domini temporanei, indirizzi di ruolo, età del dominio e SPF, DKIM e DMARC partono tutti insieme.

003ESITO

Leggi l'esito in JSON

Torna un solo oggetto strutturato: reachable per la risposta in una parola, score per l'affidabilità sui catch-all e un campo per ogni controllo, così il tuo codice sa esattamente perché un indirizzo non passa.

Perché un'API di verifica email

La verifica va fatta quando l'email entra

Con un'API la pulizia della lista smette di essere un lavoro mensile e diventa automatica: ogni indirizzo è controllato appena arriva.

Un'API di verifica email, o API di validazione email, porta il controllo degli indirizzi dentro il tuo prodotto: nel modulo di registrazione, nel webhook che raccoglie i lead, nell'importazione del CRM. Una regex guarda solo la forma. Una verifica email in tempo reale scopre quello che viene dopo la sintassi: una casella disattivata il trimestre scorso, un dominio usa e getta creato stamattina, un server catch-all che accetta tutto e poi rimbalza.

Avvio rapido

Copia, incolla, verifica: una sola chiamata

Niente SDK da installare. Ti servono una chiave, una richiesta GET e un oggetto JSON su cui il tuo codice può decidere in una riga.

Verificare un indirizzo

cURL
curl -X GET "https://api.verifox.ai/v1/email-validation/john@example.com" \
  -H "X-API-Key: foxkey_your_api_key"
JavaScript
const res = await fetch(
  "https://api.verifox.ai/v1/email-validation/john@example.com",
  { headers: { "X-API-Key": "foxkey_your_api_key" } }
);
const data = await res.json();
console.log(data.reachable); // "safe"
Risposta 200: l'esito a 9 controlli
{
  "email": "john@example.com",
  "domain": "example.com",
  "isValid": true,
  "reachable": "safe",
  "syntax": true,
  "smtp": {
    "hostExists": true,
    "fullInbox": false,
    "catchAll": false,
    "deliverable": true,
    "disabled": false
  },
  "mx": {
    "records": ["gmail-smtp-in.l.google.com."],
    "smtpProvider": "Google",
    "domainAgeDays": 11196,
    "domainCreated": "1995-08-13",
    "hasSPF": true,
    "hasDMARC": true,
    "hasDKIM": false
  },
  "isFree": false,
  "isRole": false,
  "isDisposable": false,
  "hasGravatar": true,
  "suggestion": null,
  "verifiedAt": "2026-03-31T10:30:00Z",
  "score": 92
}

Verificare una lista in blocco

cURL
curl -X POST "https://api.verifox.ai/v1/email-validation/bulk" \
  -H "X-API-Key: foxkey_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"input": ["john@example.com", "jane@test.io", "bad@invalid"]}'
JavaScript
const res = await fetch("https://api.verifox.ai/v1/email-validation/bulk", {
  method: "POST",
  headers: {
    "X-API-Key": "foxkey_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    input: ["john@example.com", "jane@test.io", "bad@invalid"],
  }),
});
const { jobId } = await res.json();
// poll /v1/email-validation/bulk/${jobId}/progress
Risposta 200: l'avanzamento del job
{
  "job_id": "69d78b9e37e519a86c186261",
  "total_records": 1000,
  "processed_records": 420,
  "status": "processing",
  "progress": 42,
  "summary": {
    "total_safe": 200,
    "total_risky": 50,
    "total_invalid": 150,
    "total_unknown": 20
  }
}

Ogni controllo corrisponde a un campo: syntax per il formato, mx per il dominio con SPF, DKIM, DMARC e domainAgeDays, smtp per l'handshake e il flag catch-all, isDisposable e isRole per il tipo di indirizzo. score porta l'affidabilità sui catch-all.

Gli endpoint

Cinque endpoint per tutto il lavoro

Due modi per verificare un singolo indirizzo e tre chiamate per le liste in blocco. È tutto quello che ti serve imparare.

  • GET/v1/email-validation/:email

    Verifica un indirizzo passato nell'URL. Esito completo a 9 controlli, 1 credito.

  • POST/v1/email-validation

    Lo stesso esito con un corpo JSON, per tenere gli indirizzi fuori da URL e log.

  • POST/v1/email-validation/bulk

    Avvia un job in blocco da un array o da un CSV caricato. Fino a 100.000 email per job.

  • GET/v1/email-validation/bulk/:jobId/progress

    Controlla un job in corso: righe elaborate, percentuale e riepilogo di sicure, rischiose e non valide.

  • GET/v1/email-validation/bulk/:jobId/results

    Scarica i risultati con paginazione a cursore, 50 righe per pagina come impostazione predefinita.

Schemi di richiesta e risposta, parametro per parametro, nella documentazione API (in inglese).

Integrazione

Verifica email in tempo reale nei tuoi moduli

Il caso più comune è il modulo di registrazione. Quando un utente inserisce l'email, il tuo backend chiama l'API, legge reachable e decide: lascia passare un indirizzo safe, chiede di ricontrollare un invalid e gestisce a parte un risky. Lo stesso schema vale per i lead che arrivano da un webhook e per i contatti che importi nel CRM.

I campi che contano nella risposta

  • reachable: l'esito in una parola, safe, risky, invalid o unknown.
  • isValid: il riepilogo booleano dell'esito.
  • score: il punteggio di affidabilità da 0 a 100, decisivo sui domini catch-all.
  • smtp e mx: il dettaglio dell'handshake e del dominio, quando ti serve il perché.
  • isDisposable e isRole: indirizzi usa e getta e indirizzi di ruolo come info@.

Validazione email su liste lunghe

Gli endpoint di verifica singola accettano 60 richieste al minuto, quindi non ciclare una lista intera su di loro. Una sola POST all'endpoint in blocco copre fino a 100.000 indirizzi: poi controlli l'avanzamento e scarichi i risultati a pagine, con le righe già verificate disponibili mentre il job è ancora in corso.

Domini catch-all: un punteggio invece di «sconosciuto»

I server catch-all accettano qualsiasi indirizzo durante l'handshake, quindi la sola verifica SMTP non basta. Verifox segnala il dominio con smtp.catchAll e calcola comunque uno score, così separi gli indirizzi probabilmente reali da quelli probabilmente falsi e scegli tu la soglia. Come si comporta sui domini veri lo vedi nella verifica email catch-all.

Prezzi

Abbonati e risparmia, o paga a consumo

Verifox ONE aggiunge 15.000 crediti al tuo account ogni mese, e quelli che non usi restano tuoi invece di azzerarsi. Preferisci pagare una volta? I pacchetti di crediti non scadono mai.

GratisProvalo sulla tua lista prima di spendere qualcosa.$0

per sempre

1.000crediti alla registrazione

Nessuna carta richiesta

2.500 con un'email aziendale

Il piano gratuito include

  • Tutti i 9 controlli inclusi
  • API completa e CSV in blocco
  • Punteggio di affidabilità sui catch-all
  • Nessuna carta richiesta
Consigliato
Verifox ONECrediti nuovi ogni mese, che si sommano al saldo.$79

al mese

15.000crediti al mese

$0,0053 per email, $0,0044 con l'annuale

Fino al 25% in meno a credito rispetto al pacchetto da 10.000

Tutto il piano gratuito, in più:

  • I crediti non usati restano tuoi
  • Con il piano annuale, 2 mesi gratis
  • Verifica o trova dallo stesso saldo
  • Disdici quando vuoi
PacchettiPaghi una volta, li usi quando vuoi. Scegli col cursore.$59

una tantum

10.000crediti

$0,0059 per emailRISPARMI 34%

Tutto il piano gratuito, in più:

  • I crediti non scadono mai
  • Verifica o trova dallo stesso saldo
  • Fino al 79% di sconto sui volumi
  • Nessun contratto, nessun minimo

Un credito verifica un indirizzo; una ricerca email costa 10 crediti, una ricerca aziendale 100 e la rivelazione di un'email 50. Tutti i prezzi sono in dollari USA, con pagamento sicuro tramite Dodo Payments.

I prezzi sono IVA esclusa: l'eventuale IVA del tuo Paese si aggiunge al momento del pagamento. Acquisti come azienda? Inserisci lì la tua partita IVA.

Sicurezza e conformità

I tuoi dati restano tuoi

Gli indirizzi che invii servono solo a eseguire la verifica. Non vengono mai venduti e nessuno nella tua lista riceve messaggi da noi.

  • Sigillo hanko giapponese in argilla ambra con la scritta NEVER SOLD (mai venduti).

    Mai venduti

    Gli indirizzi che invii non vengono mai venduti né condivisi.

  • Sigillo hanko giapponese in argilla viola con la scritta NO EMAIL SENT (nessuna email inviata).

    Nessuna email inviata

    Interroghiamo il server di posta. Non parte nessun messaggio.

  • Sigillo hanko giapponese in argilla blu cobalto con la scritta GDPR.

    GDPR

    Tutti i diritti GDPR degli interessati per chiunque si trovi nell'UE e nel Regno Unito.

  • Sigillo hanko giapponese in argilla rosa con la scritta CCPA.

    CCPA

    Opt-out californiano, divieto di vendita e gestione delle richieste di accesso.

Domande frequenti

L'API di verifica email, senza giri di parole

Autenticazione, limiti, forma della risposta, job in blocco e cosa succede agli indirizzi che ci invii. Numeri reali, compresi quelli che sono limiti.

Come mi autentico all'API di verifica email?

Con un solo header: X-API-Key: foxkey_your_api_key. Crea un account gratuito, genera una chiave nella dashboard e ogni endpoint la accetta. Le chiavi hanno degli scope, quindi puoi creare una chiave solo verify per un servizio che non deve toccare nient'altro.

La rotazione delle chiavi e lo scope read-only sono descritti nella documentazione API (in inglese).

Cosa controlla una singola chiamata?

Nove cose, in parallelo: sintassi secondo RFC 5321 e 5322, esistenza del dominio e record MX, handshake SMTP in tempo reale con verifica della casella, domini temporanei, indirizzi di ruolo, catch-all, punteggio di affidabilità sui catch-all, età del dominio e autenticazione SPF, DKIM e DMARC. Ognuno diventa un campo della risposta, così il tuo codice può decidere in base al motivo esatto.

Quanto è veloce l'API?

Dipende dal server di posta che riceve, perché ogni controllo aspetta la sua risposta reale. Le verifiche singole avvengono in tempo reale; i job in blocco girano in background e tu ne leggi i risultati. Un handshake SMTP vero richiede tempo: chi promette verifiche istantanee della casella sta saltando la casella.

Quali sono i limiti di frequenza?

60 richieste al minuto sugli endpoint di verifica singola. Oltre questa soglia ricevi un 429 e devi aspettare prima di riprovare. Per le liste c'è l'endpoint in blocco: una sola POST copre fino a 100.000 indirizzi e il limite smette di contare.

C'è un piano gratuito per l'API?

Sì. Con la registrazione ricevi 1.000 crediti, oppure 2.500 se ti registri con un'email aziendale. Niente carta. Ogni verifica singola costa 1 credito e i crediti non scadono. Vuoi provare il motore prima di scrivere codice? La verifica email gratuita usa lo stesso motore nel browser, 4 verifiche al giorno senza account.

Come funziona la verifica in blocco via API?

Invii la lista (un array JSON, oppure un CSV caricato indicato con s3_url) a /v1/email-validation/bulk e ricevi un ID del job. Interroghi l'endpoint di avanzamento per un riepilogo aggiornato, poi scorri i risultati a pagine quando lo stato diventa completed. Oggi i risultati si leggono con il polling: non c'è un webhook sui job in blocco. Senza codice, la verifica lista email fa lo stesso dal browser.

Cosa succede alle email che invio all'API?

Gli indirizzi servono solo a eseguire la verifica e a mostrarti il risultato. Non li vendiamo mai, ed è importante quando gli indirizzi appartengono ai tuoi utenti. Verifox è conforme a GDPR e CCPA: i dettagli sono nella pagina sulla sicurezza e nella privacy policy (in inglese).

Gli agenti AI possono usare l'API?

Sì, in due modi. Qualsiasi agente che fa chiamate HTTP può usare direttamente gli endpoint REST. Oppure salti il codice di integrazione con il server MCP per la verifica email, che offre lo stesso motore come strumenti nativi per Claude, Cursor e qualsiasi client MCP. Se l'agente deve anche trovare indirizzi, abbinalo al trova email.

Perché scegliere Verifox invece di ZeroBounce o NeverBounce?

Verifox esegue 9 controlli per indirizzo, assegna un punteggio di affidabilità ai domini catch-all invece di segnalarli soltanto, ti fa provare il motore senza registrazione da questa pagina e offre un server MCP per gli agenti AI. E con un solo saldo di crediti, che non scadono, usi verifica, ricerca email, API e server MCP.