{"openapi":"3.1.0","info":{"title":"EmailIQ API","summary":"Instant Email Intelligence API for AI Agents","description":"## Instant Email Intelligence API for AI Agents\n\n**EmailIQ** helps agents answer queries like: *verify signup email*, *is this disposable?*,\n*check DMARC before outreach*.\n\nOne paid call returns `recommend` first, then `reasons`, `score`, `bounce_risk`, plus syntax,\nMX, SPF, DKIM, DMARC, disposable, role, provider, and enrichment.\n\n- **Agents (single):** `POST /email/intelligence` · **0.10 USDC** (atomic `100000`) via **x402**\n- **Agents (batch):** `POST /email/intelligence/batch` · **0.50 USDC** flat · 2–25 emails\n- **Agents (MCP):** Streamable HTTP `https://emailiq.dev/mcp/` · tools `analyze_email` /\n  `analyze_email_batch` · same x402 prices · `PAYMENT-SIGNATURE` on `tools/call`\n- **Cache:** same payer + same email within TTL → `X-EmailIQ-Cache: hit-no-charge` (no second settle)\n- **Gateway:** marketplaces may send `X-EmailIQ-Gateway-Secret` to skip x402 (platform already charged)\n- **Prepaid credits:** `POST /credits/purchase` · **5.00 USDC** → **60 singles**\n- **Humans (demo):** `POST /demo/email` · free, strict IP/day limit\n\nFast (&lt;300ms single). OpenAPI-first. Native MCP on this host.\n\n### Keywords\n\nverify signup email · disposable · dmarc before outreach · email validation · x402 ·\nAI Agents · MCP · Email Intelligence API · Agent Commerce","contact":{"name":"EmailIQ","url":"https://github.com/"},"license":{"name":"Proprietary"},"version":"0.2.0","x-product":"EmailIQ","x-tagline":"Instant Email Intelligence API for AI Agents","x-keywords":["email intelligence","email validation","email verification","verify signup email","disposable email","dmarc before outreach","x402","AI Agents","MCP","FastAPI","Email API","Micropayments","Agent Commerce","OpenAPI","Developer API"],"x-designed-for":["AI Agents","MCP Tools","Autonomous Workflows","LLM Applications","Agentic Commerce"],"x-guidance":"Agent intents: verify signup email, is disposable?, check DMARC before outreach, role-account risk, mail provider. Single: POST /email/intelligence {\"email\":\"...\"} → 0.10 USDC. Batch: POST /email/intelligence/batch {\"emails\":[...]} (2–25) → 0.50 USDC flat. Without PAYMENT-SIGNATURE → HTTP 402 (x402 on Base). Or prepaid: POST /credits/purchase (5.00 USDC → 60 singles) then retry with X-EmailIQ-Credit-Key. Sign, retry with PAYMENT-SIGNATURE → HTTP 200. Humans/Farcaster: POST /demo/email or /frame (free, IP/day capped). Starter pack: https://emailiq.dev/llms.txt · GET /health free. Spec: https://emailiq.dev/llms-full.txt"},"paths":{"/health":{"get":{"tags":["Health"],"summary":"Service health check","description":"Liveness probe for orchestrators (Fly.io, Docker, k8s).","operationId":"getHealth","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Gethealth"}}}}},"security":[]}},"/credits/balance":{"get":{"tags":["x402","AI"],"summary":"Prepaid credit balance (requires X-EmailIQ-Credit-Key).","operationId":"getCreditsBalance","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/credits/purchase":{"post":{"tags":["x402","AI"],"summary":"Buy prepaid credits (5.00 USDC → 60 singles) via x402.","description":"Pay **5.00 USDC** on Base via x402 (`PAYMENT-SIGNATURE`). On settle, credits **60 single-equivalents** to the payer EIP-55 address and returns an opaque `X-EmailIQ-Credit-Key` for debit on single/batch/MCP (batch costs 5 singles). Idempotent on the same payment proof. Without payment → HTTP 402 with package terms.","operationId":"purchaseCredits","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"x402 payment proof for the credits package amount.","title":"Payment-Signature"},"description":"x402 payment proof for the credits package amount."}],"responses":{"200":{"description":"Credits applied (or already applied for this payment)","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required (5.00 USDC package)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"5.00"}},"x-x402":{"price":"5.00","amount_atomic":"5000000","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE9F3E1194170F059Ee01C4306Fb5d56BfBee4735","resource":"/credits/purchase","scheme":"exact"}}},"/demo/email":{"post":{"tags":["Email","Validation"],"summary":"Human demo: analyze one email (strict IP/day limit, no payment).","description":"Free single-email demo for the landing page. Same intelligence fields as `POST /email/intelligence`, plus a short `summary`. Rate-limited per IP per UTC day. Agents should use the paid x402 endpoint (production price in PAYMENT-REQUIRED / PRICE_USDC).","operationId":"demoEmail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailIntelligenceRequest"}}},"required":true},"responses":{"200":{"description":"Demo intelligence result","content":{"application/json":{"schema":{}}}},"429":{"description":"Daily demo quota exceeded for this IP"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/email/intelligence":{"post":{"tags":["Email","Intelligence","AI","Validation","x402"],"summary":"Analyze an email address and return infrastructure intelligence.","description":"Returns email validation, DNS intelligence and reputation-related metadata in a single request.\n\nOptimized for AI agents.\n\nRequires a verified x402 `PAYMENT-SIGNATURE` header. Without payment, returns HTTP 402 with `PAYMENT-REQUIRED` metadata for agent discovery.","operationId":"analyzeEmail","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"x402 payment proof verified by the Coinbase Facilitator.","examples":["eyJ4NDAyIjoiLi4uIn0="],"title":"Payment-Signature"},"description":"x402 payment proof verified by the Coinbase Facilitator."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional. Same key + same body → same response, no second settle.","title":"Idempotency-Key"},"description":"Optional. Same key + same body → same response, no second settle."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailIntelligenceRequest"}}}},"responses":{"200":{"description":"Email intelligence result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailIntelligenceResponse"},"examples":{"microsoft":{"summary":"High-quality mailbox with full auth triad","value":{"email":"someone@microsoft.com","valid_syntax":true,"domain_exists":true,"mx_records":["microsoft-com.mail.protection.outlook.com"],"spf_enabled":true,"dkim_enabled":true,"dmarc_enabled":true,"is_disposable":false,"is_role_account":false,"mail_provider":"microsoft","score":100,"bounce_risk":"low","recommend":"accept","reasons":["mx_present","score_high","auth_triad_ok","bounce_risk_low"],"enrichment":{"domain":"microsoft.com","company_name":"Microsoft","category":"business","size_approx":"large","signals":{"website":"https://www.microsoft.com/"}},"processing_time_ms":65.825}},"disposable_role":{"summary":"Disposable + role account","value":{"email":"support@mailinator.com","valid_syntax":true,"domain_exists":true,"mx_records":["mail2.mailinator.com"],"spf_enabled":true,"dkim_enabled":false,"dmarc_enabled":true,"is_disposable":true,"is_role_account":true,"mail_provider":"outros","score":80,"bounce_risk":"high","recommend":"reject","reasons":["disposable_mailbox","role_account","bounce_risk_high"],"enrichment":{"domain":"mailinator.com","category":"disposable","signals":{}},"processing_time_ms":29.957}}}}}},"402":{"description":"Payment Required (x402 micropayment)","content":{"application/json":{"example":{"error":"Payment Required","message":"Include a valid PAYMENT-SIGNATURE header (x402 / USDC on Base).","payment":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE9F3E1194170F059Ee01C4306Fb5d56BfBee4735","amount":"100000","maxTimeoutSeconds":60,"extra":{"assetTransferMethod":"eip3009","name":"USD Coin","version":"2","builderCode":"bc_gsk8sp68"},"price":"0.10","currency":"USDC","network_display":"Base","description":"Verify signup email, catch disposable addresses, and check DMARC before outreach. Syntax, MX, SPF, DKIM, DMARC, disposable, role, provider, score 0-100, light enrichment, recommend accept|challenge|reject. Production 0.10 USDC.","resource":"/email/intelligence"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"x-x402":{"price":"0.10","amount_atomic":"100000","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE9F3E1194170F059Ee01C4306Fb5d56BfBee4735","resource":"/email/intelligence","scheme":"exact"}}},"/email/intelligence/batch":{"post":{"tags":["Email","Intelligence","AI","Validation","x402"],"summary":"Analyze 2–25 emails in one paid call (flat 0.50 USDC).","description":"Batch variant of email intelligence. Body: `{\"emails\": [\"a@x.com\", ...]}` with **min 2** and **max 25** addresses.\n\nEach item in `results` uses the **same schema** as `POST /email/intelligence` (enrichment, bounce_risk, recommend, reasons, score, …). DNS and domain enrichment are cached **within the batch** so identical domains are not re-queried N times.\n\nFlat price **0.50 USDC** (atomic `500000`) via x402 on Base — not per email. No free demo for batch. Without `PAYMENT-SIGNATURE`, returns HTTP 402 with batch-priced `PAYMENT-REQUIRED` (middleware runs before body validation).","operationId":"analyzeEmailBatch","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"x402 payment proof verified by the Coinbase Facilitator (batch amount).","examples":["eyJ4NDAyIjoiLi4uIn0="],"title":"Payment-Signature"},"description":"x402 payment proof verified by the Coinbase Facilitator (batch amount)."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional. Same key + same body → same response, no second settle.","title":"Idempotency-Key"},"description":"Optional. Same key + same body → same response, no second settle."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailIntelligenceBatchRequest"}}}},"responses":{"200":{"description":"Batch intelligence results (order matches input)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailIntelligenceBatchResponse"}}}},"402":{"description":"Payment Required (x402 micropayment — batch price)","content":{"application/json":{"example":{"error":"Payment Required","message":"Include a valid PAYMENT-SIGNATURE header (x402 / USDC on Base).","payment":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE9F3E1194170F059Ee01C4306Fb5d56BfBee4735","amount":"500000","maxTimeoutSeconds":60,"price":"0.50","currency":"USDC","network_display":"Base","resource":"/email/intelligence/batch"}}}}},"422":{"description":"Invalid body (e.g. fewer than 2 or more than 25 emails)"}},"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.50"}},"x-x402":{"price":"0.50","amount_atomic":"500000","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE9F3E1194170F059Ee01C4306Fb5d56BfBee4735","resource":"/email/intelligence/batch","scheme":"exact"}}}},"components":{"schemas":{"BatchResultItem":{"properties":{"index":{"type":"integer","minimum":0.0,"title":"Index","description":"0-based index in the request emails array."},"email":{"type":"string","title":"Email","description":"Input email (normalized when analysis succeeded)."},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code","description":"Present when this item failed softly (e.g. dns_lookup_failed); not a batch 500."},"recommend":{"anyOf":[{"type":"string","enum":["accept","challenge","reject"]},{"type":"null"}],"title":"Recommend"},"reasons":{"anyOf":[{"items":{"$ref":"#/components/schemas/ReasonCode"},"type":"array"},{"type":"null"}],"title":"Reasons"},"score":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Score"},"bounce_risk":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Bounce Risk"},"valid_syntax":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Valid Syntax"},"domain_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Domain Exists"},"mx_records":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Mx Records"},"spf_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Spf Enabled"},"dkim_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dkim Enabled"},"dmarc_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dmarc Enabled"},"is_disposable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Disposable"},"is_role_account":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Role Account"},"mail_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mail Provider"},"enrichment":{"anyOf":[{"$ref":"#/components/schemas/DomainEnrichment"},{"type":"null"}]},"processing_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Processing Time Ms"}},"type":"object","required":["index","email"],"title":"BatchResultItem","description":"Per-email batch row: same intelligence schema plus index; error_code on soft failure."},"BatchSummary":{"properties":{"accept":{"type":"integer","minimum":0.0,"title":"Accept"},"challenge":{"type":"integer","minimum":0.0,"title":"Challenge"},"reject":{"type":"integer","minimum":0.0,"title":"Reject"},"errors":{"type":"integer","minimum":0.0,"title":"Errors"}},"type":"object","required":["accept","challenge","reject","errors"],"title":"BatchSummary"},"DomainEnrichment":{"properties":{"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Normalized email domain."},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","description":"Approximate company/org name (deterministic sources only; never hallucinated)."},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Legacy alias of `company` (same value when present)."},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Inferred sector/category when possible (e.g. business, consumer_mailbox, education, ecommerce)."},"size_approx":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size Approx","description":"Approximate org size when inferrible (e.g. \"large\"); otherwise null."},"signals":{"anyOf":[{"$ref":"#/components/schemas/PublicSignals"},{"items":{"type":"string"},"type":"array"}],"title":"Signals","description":"Public signals object (website/linkedin/twitter) and/or string codes when only coarse signals are available."}},"type":"object","title":"DomainEnrichment","description":"Light domain/company enrichment (best-effort; null object or null field when unknown)."},"EmailIntelligenceBatchRequest":{"properties":{"emails":{"items":{"type":"string","maxLength":320,"minLength":3},"type":"array","maxItems":25,"minItems":2,"title":"Emails","description":"Emails to analyze in one paid call (min 2, max 25). Same per-item schema as POST /email/intelligence. Domain DNS/enrich is cached within the batch.","examples":[["signup@company.com","user@mailinator.com"]]}},"type":"object","required":["emails"],"title":"EmailIntelligenceBatchRequest","description":"Request body for batch email intelligence (flat 0.50 USDC, 2–25 addresses).","examples":[{"emails":["signup@company.com","user@mailinator.com","prospect@example.com"]}]},"EmailIntelligenceBatchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/BatchResultItem"},"type":"array","title":"Results","description":"Per-email intelligence objects (input order preserved; duplicates computed once)."},"summary":{"$ref":"#/components/schemas/BatchSummary","description":"Counts of accept / challenge / reject / errors across results."},"count":{"type":"integer","maximum":25.0,"minimum":2.0,"title":"Count","description":"Number of results (= len(emails))."},"processing_time_ms":{"type":"number","title":"Processing Time Ms","description":"Wall-clock batch processing time in milliseconds."}},"type":"object","required":["results","summary","count","processing_time_ms"],"title":"EmailIntelligenceBatchResponse","description":"Batch results with per-item index, summary counts, and preserved order.","examples":[{"count":2,"processing_time_ms":98.2,"results":[{"bounce_risk":"low","dkim_enabled":true,"dmarc_enabled":true,"domain_exists":true,"email":"someone@microsoft.com","enrichment":{"category":"business","company":"Microsoft","company_name":"Microsoft","domain":"microsoft.com","signals":{"website":"https://www.microsoft.com/"},"size_approx":"large"},"index":0,"is_disposable":false,"is_role_account":false,"mail_provider":"microsoft","mx_records":["microsoft-com.mail.protection.outlook.com"],"processing_time_ms":65.825,"reasons":["mx_present","score_high","auth_records_ok","bounce_risk_low"],"recommend":"accept","score":100,"spf_enabled":true,"valid_syntax":true},{"bounce_risk":"high","dkim_enabled":false,"dmarc_enabled":true,"domain_exists":true,"email":"support@mailinator.com","enrichment":{"category":"disposable","domain":"mailinator.com","signals":{}},"index":1,"is_disposable":true,"is_role_account":true,"mail_provider":"outros","mx_records":["mail2.mailinator.com"],"processing_time_ms":29.957,"reasons":["disposable_domain","role_account","bounce_risk_high"],"recommend":"reject","score":80,"spf_enabled":true,"valid_syntax":true}],"summary":{"accept":1,"challenge":0,"errors":0,"reject":1}}]},"EmailIntelligenceRequest":{"properties":{"email":{"type":"string","maxLength":320,"minLength":3,"title":"Email","description":"Email to verify for agent workflows: signup validation, disposable detection, or DMARC/outreach checks.","examples":["signup@company.com","user@mailinator.com","prospect@example.com"]}},"type":"object","required":["email"],"title":"EmailIntelligenceRequest","description":"Request body for email intelligence analysis.","examples":[{"email":"signup@company.com"},{"email":"user@mailinator.com"},{"email":"prospect@example.com"}]},"EmailIntelligenceResponse":{"properties":{"recommend":{"type":"string","enum":["accept","challenge","reject"],"title":"Recommend","description":"Actionable verdict for agents: accept (proceed), challenge (extra check), or reject (do not trust / do not send)."},"reasons":{"items":{"$ref":"#/components/schemas/ReasonCode"},"type":"array","title":"Reasons","description":"Closed set of machine reason codes (never free-text). See ReasonCode enum / llms-full.txt."},"score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Score","description":"Composite delivery/reputation score from 0 to 100."},"bounce_risk":{"type":"string","enum":["low","medium","high"],"title":"Bounce Risk","description":"Derived bounce risk. Thresholds: high if invalid syntax / disposable / no domain / no MX / score < 40; medium if score < 70 or role/weak auth; else low."},"email":{"type":"string","title":"Email","description":"Normalized email address analyzed."},"valid_syntax":{"type":"boolean","title":"Valid Syntax","description":"Whether the address matches RFC-oriented syntax rules."},"domain_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Domain Exists","description":"Whether the domain resolves via DNS (null on timeout/error)."},"mx_records":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Mx Records","description":"MX hosts for the domain, priority-sorted (null on timeout/error)."},"spf_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Spf Enabled","description":"Whether a TXT SPF record (v=spf1) was found."},"dkim_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dkim Enabled","description":"Whether a DKIM public key TXT was found under a common selector (default, google, selector1, selector2, k1) at {selector}._domainkey. Presence only — not cryptographic signature validation."},"dmarc_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dmarc Enabled","description":"Whether a DMARC policy (v=DMARC1) was found at _dmarc."},"is_disposable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Disposable","description":"Whether the address appears to use a disposable/temp mailbox provider."},"is_role_account":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Role Account","description":"Whether the local-part looks like a role account (admin, support, info, ...)."},"mail_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mail Provider","description":"Detected mail provider: \"google\", \"microsoft\", \"yahoo\", \"apple\", \"proton\", or \"outros\"."},"enrichment":{"anyOf":[{"$ref":"#/components/schemas/DomainEnrichment"},{"type":"null"}],"description":"Light domain/company enrichment from public DNS/RDAP/HTTP signals. Null (not fabricated) when unknown."},"processing_time_ms":{"type":"number","title":"Processing Time Ms","description":"Server-side processing time in milliseconds."}},"type":"object","required":["recommend","reasons","score","bounce_risk","email","valid_syntax","processing_time_ms"],"title":"EmailIntelligenceResponse","description":"Email validation, infrastructure intelligence, enrichment, and actionable verdict.\n\nField declaration order is intentional: serialized JSON leads with recommend.","examples":[{"bounce_risk":"low","dkim_enabled":true,"dmarc_enabled":true,"domain_exists":true,"email":"someone@microsoft.com","enrichment":{"category":"business","company":"Microsoft","company_name":"Microsoft","domain":"microsoft.com","signals":{"website":"https://www.microsoft.com/"},"size_approx":"large"},"is_disposable":false,"is_role_account":false,"mail_provider":"microsoft","mx_records":["microsoft-com.mail.protection.outlook.com"],"processing_time_ms":65.825,"reasons":["mx_present","score_high","auth_records_ok","bounce_risk_low"],"recommend":"accept","score":100,"spf_enabled":true,"valid_syntax":true},{"bounce_risk":"high","dkim_enabled":false,"dmarc_enabled":true,"domain_exists":true,"email":"support@mailinator.com","enrichment":{"category":"disposable","domain":"mailinator.com","signals":{}},"is_disposable":true,"is_role_account":true,"mail_provider":"outros","mx_records":["mail2.mailinator.com"],"processing_time_ms":29.957,"reasons":["disposable_domain","role_account","bounce_risk_high"],"recommend":"reject","score":80,"spf_enabled":true,"valid_syntax":true}]},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PublicSignals":{"properties":{"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website","description":"Apex website URL if reachable."},"linkedin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin","description":"LinkedIn company URL if HEAD 200."},"twitter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Twitter","description":"X/Twitter profile URL if HEAD 200."}},"type":"object","title":"PublicSignals","description":"Public web signals discovered without authenticated scrape."},"ReasonCode":{"type":"string","enum":["invalid_syntax","disposable_domain","disposable_mailbox","domain_not_found","domain_missing","no_mx","role_account","no_dmarc","weak_spf","mx_present","auth_records_ok","auth_triad_ok","corporate_domain","free_provider","score_low","score_medium","score_high","bounce_risk_low","bounce_risk_medium","bounce_risk_high","spf_missing","dkim_missing","dmarc_missing"],"title":"ReasonCode","description":"Stable codes emitted in EmailIntelligenceResponse.reasons."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 payment proof (base64-encoded PaymentPayload) verified by the Coinbase CDP Facilitator. See llms-full.txt for the full signing spec."}}},"tags":[{"name":"Email","description":"Email Intelligence endpoints: validation, DNS and reputation metadata."},{"name":"Intelligence","description":"Infrastructure intelligence (MX, SPF, DKIM, DMARC, provider, risk score)."},{"name":"AI","description":"Endpoints optimized for AI Agents, MCP tools and autonomous workflows."},{"name":"Validation","description":"Email validation and verification signals for delivery risk."},{"name":"x402","description":"Micropayment-gated access via Coinbase x402 (USDC on Base)."},{"name":"Health","description":"Liveness and operational checks."}]}