Eventi di verifica
Singoli indirizzi verificati tramite l’API e ogni indirizzo di una lista di verifica al termine del suo controllo.
email_verification.created
Inviato quando verifichi un indirizzo con Verifica un indirizzo. La verifica è già completata e il payload corrisponde alla risposta dell’API. Gli indirizzi nelle liste di verifica generano invece email_verification.updated.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre email_verification.created.
objectobjectLa verifica descritta dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto verifica
idstringID della verifica (ev_…).
objectstringSempre email_verification.
emailstringIndirizzo verificato.
statusstringcompleted se il controllo è terminato, oppure failed.
scoreintegerPunteggio da 0 a 100.
riskstringlow, medium o high.
resultstringsafe, invalid, disposable, disabled, inbox_full, role o unknown. Vedi Verifica un indirizzo.
modestringfast o full. Gli indirizzi nelle liste vengono sempre controllati in modalità full.
checksobjectSingoli controlli. I controlli sulla casella smtp_connect, deliverable, disabled, inbox_full e catch_all valgono null in modalità fast.
addressobjectL’indirizzo suddiviso in mailbox, domain, suffix (la parte dopo +) e root.
did_you_meanstring | nullCorrezione suggerita per un probabile errore di battitura.
mx_recordsobject[]Record MX del dominio, ciascuno con priority e exchange.
created_atstringQuando è stata creata la verifica, in formato ISO 8601 con offset UTC.
updated_atstringQuando è stata aggiornata l’ultima volta la verifica.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification.created",
"object": {
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"free_email": false,
"gibberish": false,
"catch_all": null,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
},
"data": {
"object": {
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"free_email": false,
"gibberish": false,
"catch_all": null,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
}
}
}email_verification.updated
Inviato quando Emailit termina di verificare un indirizzo di una lista di verifica, una volta per indirizzo. Una lista di 10.000 indirizzi genera 10.000 di questi eventi; se ti serve solo sapere quando l’intera lista è terminata, ascolta invece email_verification_list.updated.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre email_verification.updated.
objectobjectLa verifica descritta dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto verifica
idstringID della verifica (ev_…).
objectstringSempre email_verification.
emailstringIndirizzo verificato.
statusstringcompleted se il controllo è terminato, oppure failed.
scoreintegerPunteggio da 0 a 100.
riskstringlow, medium o high.
resultstringsafe, invalid, disposable, disabled, inbox_full, role o unknown. Vedi Verifica un indirizzo.
modestringfast o full. Gli indirizzi nelle liste vengono sempre controllati in modalità full.
checksobjectSingoli controlli. I controlli sulla casella smtp_connect, deliverable, disabled, inbox_full e catch_all valgono null in modalità fast.
addressobjectL’indirizzo suddiviso in mailbox, domain, suffix (la parte dopo +) e root.
did_you_meanstring | nullCorrezione suggerita per un probabile errore di battitura.
mx_recordsobject[]Record MX del dominio, ciascuno con priority e exchange.
created_atstringQuando è stata creata la verifica, in formato ISO 8601 con offset UTC.
updated_atstringQuando è stata aggiornata l’ultima volta la verifica.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification.updated",
"object": {
"id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": true,
"disabled": false,
"free_email": false,
"gibberish": false,
"catch_all": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
},
"data": {
"object": {
"id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": true,
"disabled": false,
"free_email": false,
"gibberish": false,
"catch_all": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
}
}
}