{"uid":"cap_Ul4UTauM4hurRY9mq38Lw","slug":"shield-vainplex-dev-4871fe5b","name":"ShieldAPI Domain Reputation Check","description":"ShieldAPI - x402 security preflight before agents trust a domain, merchant, issuer, or callback host","url":"https://shield.vainplex.dev/api/cdp/check/domain","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Domain name to check for reputation and agent security risks (e.g. vainplex.dev)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"domain":"example.com"}}},"response":{"dns":{"a":["172.66.147.243","104.20.23.154"],"mx":[{"exchange":"","priority":0}],"ns":["elliott.ns.cloudflare.com","hera.ns.cloudflare.com"],"txt":[["_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9"],["v=spf1 -all"]],"has_spf":true,"has_dmarc":true,"has_records":true},"ssl":{"valid":true,"status":200},"domain":"example.com","blacklists":[{"list":"zen.spamhaus.org","note":"resolver-error-code","listed":false},{"list":"bl.spamcop.net","listed":false},{"list":"dnsbl.sorbs.net","listed":false}],"risk_level":"low","risk_score":0}},"exampleRequest":{"domain":"example.com"},"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XQyc550D9g75HiUR-JcBV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks a domain's security reputation, DNS records, SSL validity, blacklist status, and risk score for agent security purposes","exampleAgentPrompt":"Can you run a security reputation check on the domain 'suspiciousite.io' — I want to know its risk level, whether it's blacklisted anywhere, and if its DNS and SSL look legitimate before I let my agent interact with it.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing: DNS records (A, MX, NS, TXT), SPF/DMARC presence flags, SSL validity and HTTP status, blacklist check results across multiple lists (Spamhaus, SpamCop, SORBS), an overall risk_score (0–100), and a risk_level string (e.g. 'low', 'medium', 'high').","failureModes":["Invalid or malformed domain name returns validation error","Domain does not exist or has no DNS records — partial results returned with has_records false","DNS resolver errors on blacklist checks noted as resolver-error-code in blacklist results","Network timeout if DNS lookups are slow — may return incomplete DNS data","Missing required 'domain' query parameter returns 400 or similar error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to vet an unknown domain before interacting with it, sending data to it, or allowing it into a workflow. Especially useful for agent security pipelines where dynamically discovered URLs or API endpoints need trust scoring. Prefer over generic WHOIS tools when you need blacklist status, DNS health, and risk scoring in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:42:01.697Z","isFirstParty":false}