Aller au contenu principal

Documentation de l'API

Une adresse email, un verdict fiable.

Syntaxe, DNS, jetables, fautes de frappe, domaines pièges et dialogue SMTP : un appel HTTP renvoie un verdict, un score de 0 à 100 et le détail de chaque contrôle.

POST /v2/email/validate
curl https://api.yeswecheck.fr/v2/email/validate \
  -H "Authorization: Bearer $YWC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jean.dupont@gmail.com"}'
// 200 OK — extrait, clé avec SMTP activé
{
  "result": "valid",
  "score": 100,
  "freeProvider": true,
  "disposable": false,
  "features": {
    "smtp": {
      "result": "valid",
      "reasonCode": "MAILBOX_EXISTS"
    },
    …
  },
  "metadata": { "credits": { "used": 1 } }
}
Contrôles gratuitsSyntaxe, DNS, jetables, fautes de frappe : aucun crédit consommé.
1 crédit par SMTP conclusifUn verdict unknown n'est jamais facturé.
Une seule base d'URLhttps://api.yeswecheck.fr/v2
Hébergé en FranceDonnées hébergées en France, par OVHcloud.