Eventi delle liste di verifica
Liste di verifica create e completate.
email_verification_list.created
Inviato quando crei una lista con Crea una lista. La verifica è già iniziata, quindi status è processing e stats contiene i valori iniziali.
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_list.created.
objectobjectLa lista di 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 lista di verifica
idstringID della lista (evl_…).
objectstringSempre email_verification_list.
namestringNome della lista.
statusstringprocessing in email_verification_list.created, completed in email_verification_list.updated.
statsobjectConteggi: total_emails, processed_emails, successful_verifications, failed_verifications e pending_emails, più results con gli indirizzi completati per esito. Vedi Statistiche.
created_atstringQuando è stata creata la lista, in formato ISO 8601 con offset UTC.
updated_atstringQuando è stata aggiornata l’ultima volta la lista.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification_list.created",
"object": {
"id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
"object": "email_verification_list",
"name": "October newsletter import",
"status": "processing",
"stats": {
"total_emails": 1000,
"processed_emails": 0,
"successful_verifications": 0,
"failed_verifications": 0,
"pending_emails": 1000,
"results": {
"safe": 0,
"role": 0,
"catch_all": 0,
"unknown": 0,
"inbox_full": 0,
"disabled": 0,
"disposable": 0,
"invalid": 0
}
},
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:02.502000+00:00"
},
"data": {
"object": {
"id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
"object": "email_verification_list",
"name": "October newsletter import",
"status": "processing",
"stats": {
"total_emails": 1000,
"processed_emails": 0,
"successful_verifications": 0,
"failed_verifications": 0,
"pending_emails": 1000,
"results": {
"safe": 0,
"role": 0,
"catch_all": 0,
"unknown": 0,
"inbox_full": 0,
"disabled": 0,
"disposable": 0,
"invalid": 0
}
},
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:02.502000+00:00"
}
}
}email_verification_list.updated
Inviato quando tutti gli indirizzi di una lista di verifica hanno un esito definitivo e lo stato della lista passa a completed. stats contiene i conteggi finali e stats.results il numero di indirizzi per ciascun esito. Leggi gli esiti con Elenca gli esiti o scaricali con Esporta gli esiti.
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_list.updated.
objectobjectLa lista di 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 lista di verifica
idstringID della lista (evl_…).
objectstringSempre email_verification_list.
namestringNome della lista.
statusstringprocessing in email_verification_list.created, completed in email_verification_list.updated.
statsobjectConteggi: total_emails, processed_emails, successful_verifications, failed_verifications e pending_emails, più results con gli indirizzi completati per esito. Vedi Statistiche.
created_atstringQuando è stata creata la lista, in formato ISO 8601 con offset UTC.
updated_atstringQuando è stata aggiornata l’ultima volta la lista.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification_list.updated",
"object": {
"id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
"object": "email_verification_list",
"name": "October newsletter import",
"status": "completed",
"stats": {
"total_emails": 1000,
"processed_emails": 1000,
"successful_verifications": 996,
"failed_verifications": 4,
"pending_emails": 0,
"results": {
"safe": 702,
"role": 41,
"catch_all": 88,
"unknown": 37,
"inbox_full": 3,
"disabled": 6,
"disposable": 12,
"invalid": 107
}
},
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:41:57.020000+00:00"
},
"data": {
"object": {
"id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
"object": "email_verification_list",
"name": "October newsletter import",
"status": "completed",
"stats": {
"total_emails": 1000,
"processed_emails": 1000,
"successful_verifications": 996,
"failed_verifications": 4,
"pending_emails": 0,
"results": {
"safe": 702,
"role": 41,
"catch_all": 88,
"unknown": 37,
"inbox_full": 3,
"disabled": 6,
"disposable": 12,
"invalid": 107
}
},
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:41:57.020000+00:00"
}
}
}