{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/billionverify-com/json-schema/billionverify-com-batch-verify-request-schema.json",
  "title": "BatchVerifyRequest",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/billionverify-com-openapi.yaml#/components/schemas/BatchVerifyRequest",
  "type": "object",
  "required": [
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "email"
      },
      "description": "Array of email addresses to verify (max 50)",
      "maxItems": 50
    },
    "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 for every address in the batch. When true, all cache layers are skipped and credits are always consumed.",
      "default": false
    },
    "include_domain_reputation": {
      "type": "boolean",
      "description": "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.",
      "default": false
    }
  }
}