# Blockscout BENS Domain Lookup

> Blockscout BENS Domain Lookup is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-11).

Looks up blockchain domain names (ENS and other naming protocols) on a specific chain, returning owner, resolved address, expiry, and protocol metadata

## Facts

- Endpoint: GET https://api.blockscout.com/services/bens/api/v1/%7Bchain_id%7D/domains:lookup
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-bens-domain-lookup-4f243c4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DIFunlREbUctHRUZFf1Bd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-bens-domain-lookup-4f243c4c
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-bens-domain-lookup-4f243c4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)