{"uid":"cap_tpFhVX5ZX8RoOx-6Jj-Wo","slug":"dns-records-lookup-752a9ea6","name":"DNS Records Lookup","description":"DNS records lookup for a domain: A, AAAA, MX, TXT, NS. A record type with no entries returns an empty array, not an error. Parameter: ?domain=<domain name> (e.g. example.com).","url":"https://x402-seller-0ay3.onrender.com/api/dns/lookup","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 query (e.g. example.com)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"A":["104.20.23.154"],"MX":[{"exchange":"mail.example.com","priority":10}],"NS":["a.iana-servers.net"],"TXT":[["v=spf1 -all"]],"AAAA":[],"domain":"example.com","fetched_at":"2026-09-01T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CqEnvDrRlypU5-jDbljJ9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up DNS records (A, AAAA, MX, TXT, NS) for a given domain name and returns all record types in a single structured response","exampleAgentPrompt":"Can you look up all the DNS records for github.com — I want to see the A, MX, TXT, and NS records?","exampleUseCases":[{"title":"Email deliverability SPF check","prompt":"Pull up the TXT DNS records for mycompany.com — I want to see if our SPF record is set up correctly before we start our email campaign."},{"title":"Domain takeover or misconfiguration audit","prompt":"Look up all DNS records for acme-old-staging.com and tell me what nameservers and A records it has — I'm checking if it's still pointing somewhere or is abandoned."},{"title":"Verify new domain DNS propagation","prompt":"Check the DNS records for mynewshop.io — I just pointed it to our server and want to confirm the A record is showing the right IP address."}],"resultDescription":"A JSON object with keys A, AAAA, MX, TXT, NS, the queried domain name, and a fetched_at timestamp. Each key contains an array of records (or an empty array if none exist). MX records include both exchange hostname and priority. TXT records are arrays of string arrays. Missing record types return empty arrays rather than errors.","failureModes":["Invalid or malformed domain name returns an error response","Non-existent domain (NXDOMAIN) may return all empty arrays or an error","Network timeout if upstream DNS resolver is slow or unreachable","Missing required 'domain' query parameter returns a 400-level error","Punycode/internationalized domain names may not be supported"],"whenToPreferThis":"Use this endpoint when you need all major DNS record types for a domain in a single call, rather than making separate queries per record type. It is well-suited for domain audits, email deliverability checks, infrastructure verification, and security investigations. Prefer this over raw DNS libraries when you need a simple HTTP-based lookup with a structured JSON response that handles empty record types gracefully.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:32:03.574Z","isFirstParty":false}