Example

Email validation API example.

See a practical validation API request, response interpretation, and suppression policy for valid, invalid, risky, catch-all, and unknown addresses.

Example request

The simplest validation call accepts one email address and returns status, sub_status, confidence, provider evidence, and individual signals.

  • POST /api/v1/validate with Authorization: Bearer wii_live_...
  • Use batch or bulk endpoints when validating lists.
  • Treat unknown as inconclusive rather than safe.

Example policy

A practical product policy usually suppresses invalid and disposable addresses, segments catch-all and role addresses, and retries unknown results.

ResultPolicyReason
validAcceptEvidence suggests the mailbox is reachable.
invalidSuppressHard failures damage reputation and waste sends.
riskySegmentRisk depends on campaign and recipient context.
unknownRetry or send conservativelyThe provider did not produce reliable evidence.