Vai al contenuto
Docs

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_idstring

ID 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.

typestring

Sempre email_verification_list.created.

objectobject

La lista di verifica descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto lista di verifica

idstring

ID della lista (evl_…).

objectstring

Sempre email_verification_list.

namestring

Nome della lista.

statusstring

processing in email_verification_list.created, completed in email_verification_list.updated.

statsobject

Conteggi: total_emails, processed_emails, successful_verifications, failed_verifications e pending_emails, più results con gli indirizzi completati per esito. Vedi Statistiche.

created_atstring

Quando è stata creata la lista, in formato ISO 8601 con offset UTC.

updated_atstring

Quando è stata aggiornata l’ultima volta la lista.

JSON
{
  "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_idstring

ID 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.

typestring

Sempre email_verification_list.updated.

objectobject

La lista di verifica descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto lista di verifica

idstring

ID della lista (evl_…).

objectstring

Sempre email_verification_list.

namestring

Nome della lista.

statusstring

processing in email_verification_list.created, completed in email_verification_list.updated.

statsobject

Conteggi: total_emails, processed_emails, successful_verifications, failed_verifications e pending_emails, più results con gli indirizzi completati per esito. Vedi Statistiche.

created_atstring

Quando è stata creata la lista, in formato ISO 8601 con offset UTC.

updated_atstring

Quando è stata aggiornata l’ultima volta la lista.

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

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.