Verification

Verify single email

Verify a single email address in real-time. Returns detailed verification results including deliverability status, domain information, and risk assessment.

post/v1/verify/single

Request

  • Base URL: https://api.billionverify.com
  • URL: https://api.billionverify.com/v1/verify/single
  • Auth: API key in header BV-API-KEY

Request body

emailstring email required

Email address to verify

check_smtpboolean

Optional SMTP override: when omitted, the server default applies (production: enabled). true explicitly enables SMTP; false explicitly disables SMTP for this request.

force_refreshboolean

Bypass cached results and force a fresh live verification. When true, all cache layers are skipped and a credit is always consumed.

include_domain_reputationboolean

When true and a cached result is returned, also synchronously fetch the domain MX IP reputation (blacklist status). Adds a small latency cost but enriches domain_reputation in the response.

Example request

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

Response

Verification successful

successboolean
codestring
messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.