{"uid":"cap_1o9rtZ2sbZ-bg5wwYWTs3","slug":"payload402-dns-liveness-lookup-653673d1","name":"payload402 DNS Liveness Lookup","description":"npm package license triage for coding agents: call before npm install or adding a dependency mid-task. Returns declared license, SPDX normalization, and permissive-default compatible yes/no/unknown from the public npm registry. Triage only — not compliance-grade SBOM or legal advice. Workflow: call GET /license/check (or MCP check_npm_license) before npm install; if compatible=no, pick another package or escalate to human; if unknown, treat as risk. Example: left-pad@1.0.0 before install. Also: Convert amounts between ISO 4217 currencies using ECB daily reference rates (Frankfurter). Use for invoices, travel budgets, expense reports, and shopping comparisons when you need a verifiable rate instead of LLM arithmetic. Not live tradable FX — rates follow ECB business-day publication. Also: Resolve a place name or lat/lon to IANA timezone and coordinates (Open-Meteo). Use for agent scheduling, travel logistics, and local-time questions without LLM guessing. Not IP geolocation. Also: Translate short text between languages (Azure Translator). Use when an agent needs a verifiable string in another language for UI copy, messages, or research snippets — not legal, medical, or certified translation. Also: English Wikipedia fact lookup: search by query or exact title, returns intro extract as plain text. For agents that need a grounded summary before deeper web search. Not a substitute for primary sources. Also: Ranked search results (English Wikipedia): titles, article URLs, and snippets from MediaWiki search. Same SERP-shaped JSON as web search APIs; index is Wikipedia only — not the open web. Pair with GET /wiki/lookup for intro text.","url":"https://payload402.edgebytenet.workers.dev/dns/lookup?utm_source=zero.xyz","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":"Hostname (no scheme)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"hasA":true,"note":"DNS A/AAAA via Cloudflare DoH; not WHOIS or full DNSSEC audit","domain":"example.com","source":"cloudflare-doh","hasAAAA":false,"records":[{"ttl":300,"data":"93.184.216.34","type":"A"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XT-w4TfKpWq_WuQK8oM5s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a hostname resolves by querying A and AAAA DNS records via Cloudflare DNS-over-HTTPS","exampleAgentPrompt":"Before you try to crawl example.com, can you check if that hostname actually resolves in DNS — does it have A or AAAA records?","exampleUseCases":[{"title":"Pre-crawl domain liveness check","prompt":"Before you start scraping data from api.newstartup.io, check whether that domain actually resolves in DNS so we don't waste time on a dead hostname."},{"title":"Link validity check before publishing","prompt":"I'm about to publish a blog post with a link to docs.opensourceproject.org — can you verify that domain resolves in DNS first?"},{"title":"Monitoring new vendor domain","prompt":"We're onboarding a new vendor at vendorplatform.net — can you check if their domain resolves and tell me what IP addresses it points to?"}],"resultDescription":"Returns a JSON object indicating whether the domain has A records (IPv4) and/or AAAA records (IPv6), the actual DNS records including IP addresses and TTL values, and metadata about the source (Cloudflare DoH). Includes hasA and hasAAAA boolean flags for quick liveness checks.","failureModes":["Domain does not resolve — returns hasA: false and hasAAAA: false with empty records array","Invalid hostname format passed as input — may return an error or empty result","Cloudflare DoH upstream outage — may cause request failures or timeouts","Payment not provided or invalid — HTTP 402 response blocking the DNS query","Rate limiting if too many requests are sent in quick succession"],"whenToPreferThis":"Use this endpoint when an agent needs a fast, reliable DNS liveness check before attempting to crawl, link to, or connect to a hostname — especially when you want Cloudflare's global DNS resolver backing the check without setting up your own DNS client. Prefer this over generic HTTP reachability checks when you specifically need DNS-layer resolution (A/AAAA records) rather than full HTTP connectivity validation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:40:43.824Z","isFirstParty":false,"canonicalSlug":"payload402-dns-liveness-lookup-653673d1"}