SingleVerifyRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/billionverify-com/json-schema/billionverify-com-single-verify-request-schema.json",
  "title": "SingleVerifyRequest",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/billionverify-com-openapi.yaml#/components/schemas/SingleVerifyRequest",
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "Email address to verify"
    },
    "check_smtp": {
      "type": "boolean",
      "description": "Optional SMTP override: when omitted, the server default applies (production: enabled). true explicitly enables SMTP; false explicitly disables SMTP for this request."
    },
    "force_refresh": {
      "type": "boolean",
      "description": "Bypass cached results and force a fresh live verification. When true, all cache layers are skipped and a credit is always consumed.",
      "default": false
    },
    "include_domain_reputation": {
      "type": "boolean",
      "description": "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.",
      "default": false
    }
  }
}