Skip to main content

API documentation

One email address, one reliable verdict.

Syntax, DNS, disposable addresses, typos, trap domains and SMTP dialogue: one HTTP call returns a verdict, a score from 0 to 100 and the details of every check.

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":"john.smith@gmail.com"}'
// 200 OK — excerpt, key with SMTP enabled
{
  "result": "valid",
  "score": 100,
  "freeProvider": true,
  "disposable": false,
  "features": {
    "smtp": {
      "result": "valid",
      "reasonCode": "MAILBOX_EXISTS"
    },
    …
  },
  "metadata": { "credits": { "used": 1 } }
}
Free checksSyntax, DNS, disposable addresses, typos: no credit used.
1 credit per conclusive SMTP checkAn unknown verdict is never charged.
A single base URLhttps://api.yeswecheck.fr/v2
Hosted in FranceData hosted in France, by OVHcloud.