API 2.3.0
Independent email facts and completed checks
Choose independent email delivery and catchall facts, explicit verification assessments, and successful negative checks for supplied invalid values.
What changes
Keep delivery and catchall independent
Breaking changedeliverable and catchall each report true, false or null independently. status is deliverable, undeliverable, risky or unknown. Risky needs a specific concern: a full mailbox, a disposable address, or unresolved delivery on a catchall domain. Confirmed delivery takes priority over catchall; permanent rejection takes priority over disposable. Unknown uses temporary_failure only for a recorded transient failure, otherwise unconfirmed. All 17 existing fields remain in order.
deliverable: false, catchall: true, status: "risky", reason: "catchall"deliverable: null, catchall: true, status: "risky", reason: "catchall"Return a check result for a supplied invalid value
Breaking changeBounded invalid Email, Phone, Carrier, Caller, HLR, Name, Date and Address check values return HTTP 200 with valid: false and their complete negative response. Missing or wrong-shaped requests, invalid options, authentication failures and outages retain errors. Existing contracts retain their earlier validators.
A supplied value can be rejected by request validation with HTTP 400.HTTP 200 with valid: false for the supplied check value.