Aller au contenu
Docs

Vérifiez une adresse unique en temps réel.

URL de basehttps://api.emailit.com/v2AuthentificationErreursLimites de débit

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.

POST/email-verifications

Corps de la requête

emailstringObligatoire

Adresse à 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.

modestring

fast (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

statusstring

completed pour les vérifications unitaires.

checksobject

Contrô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).

addressobject

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

did_you_meanstring | null

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

POST/email-verifications
Terminal
curl -X POST https://api.emailit.com/v2/email-verifications \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "ada@example.com"}'
JSON
{
  "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"
}

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

Merci pour votre retour.

Merci, nous lisons chaque message.