Aller au contenu
Docs

Adresses uniques vérifiées via l’API, et chaque adresse d’une liste de vérification dès que son traitement est terminé.

email_verification.created

Envoyé lorsque vous vérifiez une adresse avec Vérifier une adresse. La vérification est déjà terminée et le payload correspond à la réponse de l’API. Les adresses des listes de vérification déclenchent plutôt email_verification.updated.

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

objectobject

La 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 vérification

idstring

ID de la vérification (ev_…).

objectstring

Toujours email_verification.

emailstring

Adresse vérifiée.

statusstring

completed lorsque la vérification est terminée, ou failed.

scoreinteger

Score de 0 à 100.

riskstring

low, medium ou high.

resultstring

safe, invalid, disposable, disabled, inbox_full, role ou unknown. Consultez Vérifier une adresse.

modestring

fast ou full. Les adresses des listes sont toujours vérifiées en mode full.

checksobject

Contrôles individuels. Les contrôles de boîte aux lettres smtp_connect, deliverable, disabled, inbox_full et catch_all valent null en mode fast.

addressobject

L’adresse décomposée en mailbox, domain, suffix (la partie après le +) et root.

did_you_meanstring | null

Correction suggérée en cas de faute de frappe probable.

mx_recordsobject[]

Enregistrements MX du domaine, chacun avec priority et exchange.

created_atstring

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

updated_atstring

Date de dernière mise à jour de la vérification.

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

Envoyé lorsqu’Emailit termine la vérification d’une adresse d’une liste de vérification, une fois par adresse. Une liste de 10 000 adresses envoie 10 000 de ces événements ; si vous avez seulement besoin de savoir quand la liste entière est terminée, écoutez plutôt email_verification_list.updated.

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

objectobject

La 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 vérification

idstring

ID de la vérification (ev_…).

objectstring

Toujours email_verification.

emailstring

Adresse vérifiée.

statusstring

completed lorsque la vérification est terminée, ou failed.

scoreinteger

Score de 0 à 100.

riskstring

low, medium ou high.

resultstring

safe, invalid, disposable, disabled, inbox_full, role ou unknown. Consultez Vérifier une adresse.

modestring

fast ou full. Les adresses des listes sont toujours vérifiées en mode full.

checksobject

Contrôles individuels. Les contrôles de boîte aux lettres smtp_connect, deliverable, disabled, inbox_full et catch_all valent null en mode fast.

addressobject

L’adresse décomposée en mailbox, domain, suffix (la partie après le +) et root.

did_you_meanstring | null

Correction suggérée en cas de faute de frappe probable.

mx_recordsobject[]

Enregistrements MX du domaine, chacun avec priority et exchange.

created_atstring

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

updated_atstring

Date de dernière mise à jour de la vérification.

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

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

Merci pour votre retour.

Merci, nous lisons chaque message.