Verification

Verify multiple emails (batch)

Verify multiple email addresses in a single synchronous request. Maximum 50 emails per request. Submitting more than 50 returns HTTP 400 with code=3103 (Batch size limit exceeded); use /v1/verify/file for larger lists. The endpoint never auto-promotes oversized batches into a file/River job.

post/v1/verify/bulk

Request

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

Request body

emailsstring[] required

Array of email addresses to verify (max 50)

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 for every address in the batch. When true, all cache layers are skipped and credits are always consumed.

include_domain_reputationboolean

When true and a cached result is returned for any email, also synchronously fetch the domain MX IP reputation. Per-row response.domain_reputation will be populated. Adds latency cost.

Example request

{
  "emails": [
    "user1@example.com",
    "user2@example.com"
  ]
}

Response

Batch verification successful

successboolean
codestring
messagestring

Changes

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