{"uid":"cap_DIFunlREbUctHRUZFf1Bd","slug":"blockscout-bens-domain-lookup-4f243c4c","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/%7Bchain_id%7D/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"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"}}},"queryParams":{"type":"object","properties":{"name":{"type":"string"},"sort":{"type":"string"},"order":{"type":"string"},"page_size":{"type":"integer"},"protocols":{"type":"string"},"page_token":{"type":"string"},"only_active":{"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_FxPKv35MkGU2rl85Ht7Nl","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) on a specific chain, returning owner, resolved address, expiry, and protocol metadata","exampleAgentPrompt":"Can you look up the ENS domain 'vitalik.eth' on Ethereum (chain ID 1) using Blockscout and tell me the resolved address, owner, and when it expires?","exampleUseCases":[{"title":"Resolve ENS domain to wallet address","prompt":"I need to find out what wallet address 'rainbowwallet.eth' resolves to on Ethereum — can you look it up using Blockscout's domain service for chain 1?"},{"title":"Check domain expiry before transfer","prompt":"Before I send funds, can you check when 'uniswap.eth' expires and who currently owns it on Ethereum mainnet using Blockscout's BENS lookup?"},{"title":"Search domains by name prefix","prompt":"Can you search for blockchain domain names starting with 'punk' on Ethereum (chain ID 1) using Blockscout, and show me the first 10 results sorted by name?"}],"resultDescription":"Returns a paginated list of domain records matching the query, each containing the domain ID, name, owner address (with optional ENS name), resolved address, wrapped owner, registration date, expiry date, the naming protocol details (ID, title, docs URL, icon, TLD list, short name, description, DApp URL and logo), and pagination parameters for fetching additional pages.","failureModes":["Invalid or unsupported chain_id returns an error or empty results","Domain name not found returns an empty items array","Invalid protocol filter string causes a 400 bad request","Missing required name query parameter may return all domains or an error","Rate limiting or payment failure (x402) returns 402 Payment Required","Malformed page_token causes pagination failure"],"whenToPreferThis":"Choose this endpoint when you need to resolve or search blockchain naming system domains (ENS, and other protocols) on a specific chain via Blockscout's BENS service. It is ideal for cross-protocol domain lookups when you want rich metadata including owner, resolved address, expiry, and protocol info in one call. Prefer it over generic blockchain RPC calls when you need structured domain metadata without writing smart contract queries. Best when the chain_id is known and you want paginated, filterable domain search results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T18:49:30.454Z","isFirstParty":false}