{"uid":"cap_ZqJEJmw53PodmifROlRUn","slug":"blockscout-bens-domain-lookup-790760c0","name":"Blockscout BENS Domain Lookup","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/services/bens/api/v1/domains: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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"name":{"type":"string"},"sort":{"type":"string"},"order":{"type":"string"},"chain_id":{"type":"string"},"page_size":{"type":"integer"},"protocols":{"type":"string"},"page_token":{"type":"string"},"only_active":{"type":"boolean"},"all_protocols":{"type":"boolean"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"id":"string","name":"string","owner":{"hash":"string","ens_domain_name":"string"},"protocol":{"id":"string","title":"string","docs_url":"string","icon_url":"string","tld_list":["string"],"short_name":"string","description":"string","deployment_blockscout_base_url":"string"},"expiry_date":"string","wrapped_owner":{"hash":"string","ens_domain_name":"string"},"resolved_address":{"hash":"string","ens_domain_name":"string"},"protocol_dapp_url":"string","registration_date":"string","protocol_dapp_logo":"string"}],"next_page_params":{"page_size":0,"page_token":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uxQTh8m0JfMBMAi0_SrAp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up blockchain domain names (ENS and other naming protocols) across multiple chains, returning owner, resolved address, protocol, and registration metadata","exampleAgentPrompt":"Can you look up the blockchain domain 'vitalik.eth' using Blockscout's naming service explorer and tell me who owns it, what address it resolves to, and when it expires?","exampleUseCases":[{"title":"Resolve ENS domain to wallet address","prompt":"What wallet address does 'uniswap.eth' resolve to? Check Blockscout's domain lookup and give me the owner and resolved address."},{"title":"Check domain expiry before bidding","prompt":"I'm thinking about acquiring 'defi.eth' — can you check if it's registered, who owns it, and when it expires using Blockscout's domain service?"},{"title":"Audit naming protocol registrations","prompt":"Search Blockscout's BENS service for all active domains registered under the ENS protocol on Ethereum mainnet (chain ID 1) and show me the first 20 results with their owners and expiry dates."}],"resultDescription":"Returns a paginated list of domain records, each containing the domain name and ID, owner address with optional ENS name, resolved wallet address, wrapped owner, registration and expiry dates, protocol details (name, title, docs, icon, TLDs, description, Blockscout base URL), and a link to the protocol dapp. Also returns pagination params for fetching subsequent pages.","failureModes":["No results returned if the domain name does not match any registered records","Invalid chain_id returns empty results or an error","Unsupported protocol name causes empty result set","Pagination token mismatch causes unexpected result ordering","Rate limiting or payment failure (402) if USDC micropayment is not supplied","Domain records may be stale if on-chain state has changed recently"],"whenToPreferThis":"Choose this endpoint when you need to resolve or look up blockchain domain names (ENS, BENS, or other naming protocols) across multiple chains and want rich metadata including owner, resolved address, expiry, and protocol details. Prefer it over generic blockchain explorers when you need cross-chain domain name service lookups in a single call, especially when filtering by protocol or chain ID matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:47:07.438Z","isFirstParty":false}