Verification

Disposable-only check (free)

Pure in-memory lookup against the embedded disposable-domain table. Does NOT consume credits, does NOT call SMTP / MX / cache. Every call writes one row to email_verification history with metadata.needs_charging=false + metadata.filtered_at="api_gateway", so the call is auditable but never billed.

See docs/disposable/disposable.md for the full design.

post/v1/verify/disposable

Request

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

Request body

emailstring email required

Example request

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

Response

Disposable check completed

successboolean

codestring

messagestring

Example response

{
  "success": true,
  "code": "0",
  "message": "Success",
  "data": {
    "email": "user@mailinator.com",
    "domain": "mailinator.com",
    "is_disposable": true
  }
}

Changes

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