← Release history

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 change

deliverable 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.

Before
deliverable: false, catchall: true, status: "risky", reason: "catchall"
API 2.3.0
deliverable: null, catchall: true, status: "risky", reason: "catchall"

API reference

Return a check result for a supplied invalid value

Breaking change

Bounded 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.

Before
A supplied value can be rejected by request validation with HTTP 400.
API 2.3.0
HTTP 200 with valid: false for the supplied check value.

API reference

Read the upgrade guide to test a version in application code. Requests without a version follow the team setting in Settings → API version. A new release does not upgrade your existing team automatically.