{"openapi":"3.1.0","info":{"title":"Email DNS Preflight","version":"1.0.0","description":"Pay-per-call email validation, DNS lookup, domain age/RDAP and mail-security intelligence for autonomous agents. Includes MX, A, AAAA, TXT, NS, CNAME, SOA, CAA, SPF, DMARC, common-selector DKIM heuristics, MTA-STS, TLS-RPT and DNSSEC. No mailbox-level SMTP claim.","x-guidance":"Use /v1/email/preflight for pre-send email hygiene; /v1/domain/preflight for DNS + mail-security + RDAP intelligence; /v1/domain/rdap for focused domain age, registrar and expiry checks. Designed for CRM hygiene, lead validation, sender vetting, domain research, DNS diagnostics, anti-phishing preflight and autonomous-agent workflows. Scores are transparent posture signals, not mailbox-existence or inbox-delivery claims.","x-keywords":["email validation API","email verification API","DNS lookup API","domain intelligence","domain age","RDAP","WHOIS successor","MX lookup","TXT lookup","SPF check","DMARC check","DKIM check","DNSSEC","domain expiry","registrar lookup","AI agent API","x402"],"contact":{"name":"Email DNS Preflight","url":"https://email-dns-preflight-x402.copper-crate.workers.dev"}},"servers":[{"url":"https://email-dns-preflight-x402.copper-crate.workers.dev"}],"components":{},"paths":{"/v1/email/preflight":{"post":{"summary":"Validate email syntax and DNS mail security posture","description":"Agent-ready email preflight for syntax, MX/Null-MX routing, A/AAAA fallback, SPF, DMARC and DNSSEC signals. DNS-level only; no SMTP mailbox-existence claim. Pay $0.001 USDC per valid call on Base.","operationId":"emailDnsPreflight","tags":["Email validation"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","description":"Email address to preflight. Practical ASCII local-parts are supported.","maxLength":254,"examples":["alice@example.com"]}},"required":["email"]},"example":{"email":"alice@example.com"}}}},"responses":{"200":{"description":"Email and domain preflight result","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"domain":{"type":"string"},"syntax":{"type":"object","properties":{"accepted":{"type":"boolean"},"profile":{"type":"string"},"roleBased":{"type":"boolean"}},"required":["accepted","profile","roleBased"]},"mailRoute":{"type":"object"},"authentication":{"type":"object"},"score":{"type":"number","minimum":0,"maximum":100},"mailbox":{"type":"object","properties":{"smtpVerified":{"type":"boolean"},"deliverabilityClaimed":{"type":"boolean"}},"required":["smtpVerified","deliverabilityClaimed"]},"domainIntelligence":{"type":"object","description":"DNS record inventory, email-authentication posture, common-selector DKIM heuristic, RDAP registration intelligence and transparent risk flags for the email domain."}},"required":["email","domain","syntax","mailRoute","authentication","score","mailbox","domainIntelligence"]}}}},"400":{"description":"Malformed or unsupported email input; not intentionally charged"},"402":{"description":"x402 payment required","headers":{"Payment-Required":{"description":"Base64-encoded x402 v2 payment challenge","schema":{"type":"string"}}}},"503":{"description":"Payment recipient not configured"}}},"get":{"summary":"Validate email syntax and DNS mail security posture","description":"GET compatibility form for agent clients and discovery systems. Supply the email as ?email=alice@example.com. Same $0.001 USDC x402 price on Base.","operationId":"emailDnsPreflightGet","tags":["Email validation"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","maxLength":254},"example":"alice@example.com"}],"responses":{"200":{"description":"Email and domain preflight result","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"domain":{"type":"string"},"score":{"type":"number","minimum":0,"maximum":100},"mailRoute":{"type":"object"},"authentication":{"type":"object"},"mailbox":{"type":"object"},"domainIntelligence":{"type":"object"}},"required":["email","domain","mailRoute","authentication","score","mailbox","domainIntelligence"]}}}},"400":{"description":"Missing or malformed email input; not intentionally charged"},"402":{"description":"x402 payment required"},"503":{"description":"Payment recipient not configured"}}}},"/v1/domain/preflight":{"get":{"summary":"DNS, RDAP and mail-security intelligence for a domain","description":"Agent-ready domain intelligence: A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SPF, DMARC, common-selector DKIM heuristics, MTA-STS, TLS-RPT, DNSSEC plus RDAP registration age, registrar and expiry. Supply ?domain=example.com. Costs $0.001 USDC on Base.","operationId":"domainDnsPreflightGet","tags":["DNS","Domain intelligence"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","maxLength":253},"example":"example.com"}],"responses":{"200":{"description":"Domain DNS and mail-security posture","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"records":{"type":"object"},"mailRoute":{"type":"object"},"authentication":{"type":"object"},"registration":{"type":"object"},"dnssec":{"type":"object"},"posture":{"type":"object"},"sources":{"type":"array","items":{"type":"string"}},"checkedAt":{"type":"string"}},"required":["domain","records","mailRoute","authentication","registration","dnssec","posture","sources","checkedAt"]}}}},"400":{"description":"Missing or malformed domain input; not intentionally charged"},"402":{"description":"x402 payment required","headers":{"Payment-Required":{"description":"Base64-encoded x402 v2 payment challenge","schema":{"type":"string"}}}},"503":{"description":"Payment recipient not configured"}}}},"/v1/domain/rdap":{"get":{"summary":"Domain age, registrar and expiry via RDAP","description":"Focused WHOIS-successor lookup for agents: domain age, registration date, expiration date, days until expiry, registrar, registry statuses, nameservers and DNSSEC delegation. No registrant personal data is returned. Supply ?domain=example.com. Costs $0.001 USDC on Base.","operationId":"domainRdapGet","tags":["RDAP","WHOIS successor","Domain intelligence"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","maxLength":253},"example":"example.com"}],"responses":{"200":{"description":"Privacy-safe RDAP registration intelligence","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"domain":{"type":"string"},"registrationDate":{"type":["string","null"]},"expirationDate":{"type":["string","null"]},"lastChangedDate":{"type":["string","null"]},"ageDays":{"type":["number","null"]},"daysUntilExpiry":{"type":["number","null"]},"registrar":{"type":["string","null"]},"statuses":{"type":"array","items":{"type":"string"}},"nameservers":{"type":"array","items":{"type":"string"}},"dnssecSigned":{"type":["boolean","null"]}},"required":["status","domain","registrationDate","expirationDate","ageDays","daysUntilExpiry","registrar","statuses","nameservers","dnssecSigned"]}}}},"400":{"description":"Missing or malformed domain input; not intentionally charged"},"402":{"description":"x402 payment required"},"503":{"description":"Payment recipient not configured"}}}}}}