Aller au contenu
Docs

Événements de liste de vérification

Listes de vérification créées et terminées.

email_verification_list.created

Envoyé lorsque vous créez une liste avec Créer une liste. La vérification a déjà commencé : status vaut donc processing et stats contient ses valeurs initiales.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

ID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.

typestring

Toujours email_verification_list.created.

objectobject

La liste de vérification décrite par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet liste de vérification

idstring

ID de la liste (evl_…).

objectstring

Toujours email_verification_list.

namestring

Nom de la liste.

statusstring

processing pour email_verification_list.created, completed pour email_verification_list.updated.

statsobject

Compteurs : total_emails, processed_emails, successful_verifications, failed_verifications et pending_emails, ainsi que results, qui compte les adresses terminées par résultat. Consultez Statistiques.

created_atstring

Date de création de la liste, au format ISO 8601 avec décalage UTC.

updated_atstring

Date de dernière mise à jour de la liste.

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

Envoyé lorsque toutes les adresses d’une liste de vérification ont un résultat définitif et que le statut de la liste passe à completed. stats contient les totaux définitifs, et stats.results le nombre d’adresses pour chaque résultat. Consultez les résultats avec Lister les résultats ou téléchargez-les avec Exporter les résultats.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

ID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.

typestring

Toujours email_verification_list.updated.

objectobject

La liste de vérification décrite par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet liste de vérification

idstring

ID de la liste (evl_…).

objectstring

Toujours email_verification_list.

namestring

Nom de la liste.

statusstring

processing pour email_verification_list.created, completed pour email_verification_list.updated.

statsobject

Compteurs : total_emails, processed_emails, successful_verifications, failed_verifications et pending_emails, ainsi que results, qui compte les adresses terminées par résultat. Consultez Statistiques.

created_atstring

Date de création de la liste, au format ISO 8601 avec décalage UTC.

updated_atstring

Date de dernière mise à jour de la liste.

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

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.