Sign in
Verification

Verify a single email address

Performs full verification (syntax, MX, SMTP mailbox probe, disposable/role/catch-all detection) and consumes 1 credit. With a test API key (cb_test_), returns a deterministic mock result instead: the local part selects the outcome (deliverable [default], undeliverable, rejected-email, invalid-domain, invalid-syntax, risky, low-quality, catch-all, disposable, role, unknown, timeout, typo, free; insufficient-credits simulates a 402). Plus-tags work too (user+risky@). Sandbox calls never spend credits and responses include "sandbox": true.

post/api/v1/verify

Request body

emailstring email required

Example request

{
  "email": "user@example.com"
}

Response

Verification result

successboolean
creditsRemaininginteger
sandboxboolean

Present and true only when the request was authenticated with a test (cb_test_) API key and the result is a sandbox mock.

Example response

{
  "success": true,
  "data": {
    "subStatus": "accepted_email",
    "reason": "accepted_email"
  },
  "creditsRemaining": 999,
  "sandbox": true
}

Changes