Vérification d’e-mails
Vérifiez une adresse unique en temps réel.
Vérifier une adresse
Vérifie une adresse e-mail et renvoie le résultat dans la réponse. Chaque vérification coûte 5 crédits, débités avant le contrôle. Pour vérifier de nombreuses adresses à la fois, créez une liste de vérification. Nécessite une clé API avec la portée full.
/email-verificationsCorps de la requête
emailstringObligatoireAdresse à vérifier. Une valeur qui n’est pas une adresse valide renvoie tout de même 200, avec result: "invalid" et un score de 0, et elle est facturée.
modestringfast (par défaut) vérifie la syntaxe, les adresses jetables et génériques, les fournisseurs gratuits, le charabia, les enregistrements MX et l’âge du domaine. full se connecte en plus au serveur de messagerie du destinataire pour vérifier si la boîte aux lettres existe, si elle est désactivée ou pleine, et si le domaine accepte toutes les adresses. Seul le mode full peut confirmer une boîte aux lettres. En mode fast, les contrôles de la boîte aux lettres valent null. full peut prendre jusqu’à 40 secondes environ quand un serveur de messagerie est lent : réglez le timeout de votre client au-delà.
Réponse
Renvoie 200 OK avec un objet email_verification. Emailit envoie aussi l’événement webhook email_verification.created.
| Statut | Cas |
|---|---|
400 |
email est absent ou mode ne vaut ni fast ni full (erreur de validation standard). |
402 |
Il reste moins de 5 crédits dans l’espace de travail. Le corps est {"error": {"message": "…", "code": 402}}. |
Résultat
result |
Signification |
|---|---|
safe |
full : le serveur de messagerie a accepté la boîte aux lettres et refusé une adresse inventée sur le même domaine. fast : aucun contrôle n’a échoué et le score est d’au moins 70 ; la boîte aux lettres n’a pas été contrôlée. |
role |
Une adresse générique, comme info@ ou support@. En mode full, la boîte aux lettres a aussi été confirmée. |
catch_all |
Le domaine accepte les e-mails pour n’importe quelle adresse : la boîte aux lettres ne peut donc pas être confirmée. Mode full uniquement. |
unknown |
Pas de réponse claire : le serveur de messagerie a bloqué ou différé le contrôle, n’a pas répondu, ou la requête DNS a échoué. En mode fast, aussi quand aucun contrôle n’a échoué mais que le score est inférieur à 70. |
inbox_full |
La boîte aux lettres est pleine. Mode full uniquement. |
disabled |
La boîte aux lettres existe, mais elle est désactivée. Mode full uniquement. |
disposable |
Le domaine appartient à un service d’adresses e-mail jetables. |
invalid |
La syntaxe est invalide, le domaine n’a pas d’enregistrement MX, ou le serveur de messagerie a indiqué que la boîte aux lettres n’existe pas. |
L’ordre dans lequel Emailit les applique figure dans Résultats de vérification.
Score et risque
score va de 0 à 100 ; les adresses qui ne peuvent pas recevoir d’e-mails obtiennent 0. risk vaut high pour invalid, disabled et disposable, et medium pour catch_all, inbox_full et unknown (high si leur score est inférieur à 50). Pour safe et role, il suit le score : low à partir de 80, medium à partir de 50 et high en dessous de 50. Consultez Score.
Champs
statusstringcompleted pour les vérifications unitaires.
checksobjectContrôles individuels : valid_syntax, disposable, role_account, free_email et gibberish (booléens), has_mx_records (booléen, ou null si la requête DNS a échoué), domain_age (âge du domaine en jours, ou null s’il est inconnu), ainsi que les contrôles du mode full : smtp_connect, deliverable, disabled, inbox_full et catch_all (null en mode fast, et en mode full quand le serveur de messagerie n’a pas donné de réponse claire).
addressobjectL’adresse décomposée en mailbox, domain, suffix (la partie après +, ou null) et root (l’adresse sans le suffixe).
did_you_meanstring | nullCorrection suggérée pour une faute de frappe probable, par exemple ada@gmail.com pour ada@gmial.com.
mx_recordsobject[]Les enregistrements MX du domaine, chacun avec priority et exchange.
{
"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,
"catch_all": null,
"free_email": false,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957,
"gibberish": false
},
"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"
}{
"error": {
"message": "Workspace has insufficient email credits for email verification. Each verification requires 5 credits.",
"code": 402
}
}