{"uid":"cap_HwVWb_Ojo4YtYPAzseyLs","slug":"forest-factory-dns-consensus-api-3102c83d","name":"Forest Factory DNS Consensus API","description":"Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/dns/consensus?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hostname":{"type":"string","pattern":"^[a-zA-Z0-9.-]+$","maxLength":253,"description":"Public hostname value used to scope this lookup."},"record_type":{"enum":["A","AAAA","CNAME","MX","NS","TXT"],"description":"Public record type value used to scope this lookup."}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"state":"agreement","hostname":"example","resolvers":[],"answer_sets":[],"record_type":"example","resolver_count":1,"failed_resolvers":0,"successful_resolvers":0},"meta":{"cache":"miss","provider":"cloudflare-doh","checked_at":"2026-01-01T00:00:00.000Z","duration_ms":0},"version":"1","capability":"dns.consensus"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_MX_BffW-oMShYWE2AC4bb","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":"Queries multiple DNS resolvers in parallel for a given hostname and record type, then returns whether they all agree on the answer (consensus state).","exampleAgentPrompt":"Can you check whether the A record for example.com is consistent across all DNS resolvers — I want to know if they're all in agreement?","exampleUseCases":[{"title":"DNS propagation check after update","prompt":"I just updated the A record for mybusiness.com — can you check if all DNS resolvers agree on it yet, or if propagation is still inconsistent?"},{"title":"Email deliverability MX record audit","prompt":"Before I go live with my new email setup, can you check whether the MX records for mycoolstartup.io are returning consistent answers across all resolvers?"},{"title":"Security check for TXT record spoofing","prompt":"Can you verify that the TXT records for securedomain.net are the same across all DNS resolvers — I want to make sure there's no inconsistency that could indicate tampering?"}],"resultDescription":"Returns a JSON object indicating the consensus state (e.g. 'agreement' or 'disagreement') across multiple DNS resolvers for the queried hostname and record type. Includes the list of resolvers queried, individual answer sets, count of successful and failed resolvers, cache hit/miss status, the DNS provider used (e.g. Cloudflare DoH), the timestamp of the check, and the duration in milliseconds.","failureModes":["Invalid hostname format returns a 400 validation error","Unsupported record type outside the allowed enum returns a 400 error","All resolvers fail to respond results in failed_resolvers count equal to resolver_count","Payment not attached or invalid returns HTTP 402 with x402 PAYMENT-REQUIRED challenge","Network timeouts may result in partial resolver responses skewing consensus"],"whenToPreferThis":"Choose this endpoint when you need to verify DNS consistency across multiple resolvers simultaneously rather than querying a single resolver. It is ideal for detecting propagation lag, split-horizon DNS, or potential DNS hijacking. Prefer it over a simple DNS lookup when consensus or agreement across the resolver network matters for your use case.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T06:31:39.103Z","isFirstParty":false,"canonicalSlug":"forest-factory-dns-consensus-api-3102c83d"}