Skip to main content

Checks

Each address goes through twenty checks, nineteen of them free: only the SMTP check uses a credit. The numbered list is published on the website; the table below groups them by API key setting (DNS covers MX and A/AAAA; domain health covers SPF, DMARC, BIMI, domain age and domain owner). Enrichment and network analysis complete the response without counting among these twenty checks. Syntax runs first: a malformed address stops there, without any network request. The other checks then run in parallel, with SMTP last.

Overview​

CheckWhat it verifiesCostKey setting
SyntaxAddress format, internationalised domains, normalisationFreeAlways active
DNSDoes the domain have a mail server (MX, or a fallback A record)?FreeAlways active
SMTPDoes the mailbox exist: a dialogue with the recipient's server, without sending a message1 credit if conclusivesmtp, disabled by default
Accept-allDoes the server accept any address?Included in SMTPwith smtp
DisposableDomain of temporary mailboxesFreedisposable
Malicious domainPhishing, scams, public blocklistsFreemaliciousDomains
Typogmial.com, hotmial.fr, orange.fe…FreetypoDomain
Verified correctionChecks the corrected address when the address entered is doubtfulFreewith typoDomain and smtp
Trap domainDomain registered to imitate a provider and capture its mailFreetyposquat
Role accountcontact@, info@, support@, admin@…FreeroleAccount
Noreply addressnoreply@, ne-pas-repondre@, mailer-daemon@, bounces@…: a mailbox nobody reads. A valid or unknown verdict becomes riskyFreenoReply
Random local partx7k3p9q2@…FreerandomDetection
Offensive termA slur in the local part (first names that contain one, such as Dominique, are excluded)Freeprofanity
Subaddressing[email protected] and per-provider equivalentsFreealiasing
EnrichmentFirst name, last name, gender, presumed age inferred from the local partFreeenrichment
Organisation listsAllowlist and blocklistFreewhitelist, blacklist
Business or consumerCompany domain or consumer provider (businessEmail, freeProvider)FreeAlways active
Domain healthMX, SPF, DMARC, BIMI, domain age and domain ownerFreedomainHealth
NetworkCaller's IP: Tor, VPN, hosting provider, countryFreenetwork

You configure these in API keys in the dashboard. A disabled check is no longer computed for that key and disappears from the response.

SMTP in detail​

SMTP is the only check that confirms a mailbox exists. YesWeCheck connects to the domain's mail server, introduces itself, announces a recipient and reads the response, then hangs up before anything is sent. No message ever arrives in the mailbox.

  • Duration: from a few hundred milliseconds to around fifteen seconds, depending on the server. Allow a client timeout of at least 30 seconds on keys with SMTP.
  • smtpTimeout: optional, in milliseconds (1,000 to 30,000), it limits how long to wait for the remote server's responses. With no value, the platform applies its own setting, adapted to each mail provider.
  • What is not charged: an SMTP check that concludes unknown (accept-all, greylisting, timeout), an address on the allowlist or blocklist (SMTP is not run in that case).

What is charged: any final verdict of valid, risky or invalid obtained with a key that has SMTP enabled, including when the verdict is reached before the dialogue (invalid syntax, domain with no server). See Credits.

Enrichment in detail​

From the local part (john.smith@…), YesWeCheck infers a probable first name and last name, then a gender and a presumed age from birth statistics (INSEE for France, equivalent national sources for other countries).

The reference country for age is chosen as follows:

  1. the request's country field, if provided (FR, US, DEU…);
  2. otherwise the domain's country-code extension (.de, .it…);
  3. otherwise France.

If there is no age data for the chosen country, presumedAge is absent rather than wrong. This information is a statistical estimate: it helps you personalise or segment, but should never be the sole basis for a decision.

Enrichment on its own, without verification, is available on POST /v2/email/enrich.