{
  "openapi": "3.1.0",
  "info": {
    "title": "Corporate Domain Email Security, DMARC/SPF/DKIM & RDAP Grader API",
    "version": "2.4.0",
    "description": "Instant DNS-over-HTTPS + RDAP email deliverability and anti-spoofing audit for AI agents, GTM teams, and MSPs. Supports free single-domain lookup, Streamable HTTP MCP, and x402 Base USDC bulk batching."
  },
  "servers": [
    {
      "url": "https://email-security-deliverability-grader.b2bintel-edge.workers.dev"
    }
  ],
  "paths": {
    "/api/grade": {
      "get": {
        "operationId": "gradeDomainEmailSecurity",
        "summary": "Audit MX, SPF, DMARC, DKIM selectors, MTA-STS, BIMI, CAA, and RDAP age for a single domain (Free)",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": "stripe.com"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Structured deliverability score, letter grade, and copy-paste DNS TXT fixes"
          }
        }
      }
    },
    "/v1/x402/bulk-grade": {
      "get": {
        "operationId": "bulkGradeDomainsX402",
        "summary": "Parallel audit of up to 12 corporate domains via x402 ($0.005 USDC on Base eip155:8453)",
        "parameters": [
          {
            "name": "domains",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "stripe.com,cal.com"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Settled batch deliverability report"
          },
          "402": {
            "description": "x402 v2 Payment Required with Bazaar discovery schema"
          }
        }
      }
    }
  }
}