# JustaName ENS Enrich

> JustaName ENS Enrich is a paid API for AI agents from api.justaname.id, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-18).

Enriches an ENS name or Ethereum address with full identity records including addresses, text records, content hash, and JAN (JustaName) status.

## Facts

- Endpoint: GET https://api.justaname.id/ens/v2/enrich?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/justaname-ens-enrich-7d8ca91e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A1xCZn_4D_RmEWWn8B9fY

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 justaname-ens-enrich-7d8ca91e
```

Example prompt: Can you pull up the full ENS profile for vitalik.eth — including their linked addresses, website URL, and any other text records on file?

## When to prefer this

Use this endpoint when you need a comprehensive ENS identity enrichment in a single call — covering text records, multi-chain addresses, and content hash together. Prefer it over the sibling resolver endpoints when you want a combined profile view rather than just address resolution or reverse lookup. Best for onboarding flows, profile display, or any scenario where you want the full identity picture for an ENS name or wallet address.

## Known failure modes

- ENS name not found — returns empty or null records
- Invalid ENS name format — request rejected
- Rate limit or payment failure — 402 response requiring x402 payment
- Unregistered address with no reverse record — empty name field
- Upstream ENS resolver timeout — delayed or failed response

## How this service works

ENS resolution, reverse resolution and identity enrichment for agents, pay per call in USDC on Base via x402 or MPP.

## Output

Returns the ENS name, associated Ethereum address, full records object containing text records (e.g. url, avatar, social handles), address records across chains, decoded content hash with protocol type, whether the name is a JustaName subname (isJAN), and whether resolution was performed via the universal resolver.

## 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": {
    "body": {},
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE",
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "type": "string"
    },
    "queryParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "enum": [
      "json",
      "text"
     ]
    },
    "format": {
     "type": "string"
    },
    "example": {}
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "vitalik.eth",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "records": {
   "ens": "vitalik.eth",
   "isJAN": false,
   "records": {
    "texts": [
     {
      "key": "url",
      "value": "https://vitalik.ca"
     }
    ],
    "addresses": [
     {
      "id": 60,
      "name": "eth",
      "value": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
     }
    ],
    "contentHash": {
     "decoded": "ipns://k51qzi5uqu5dgox2z23r6e99oqency055a6xt92xzmyvpz8mwz5ycjavm0u2u8",
     "protocolType": "ipns"
    }
   }
  },
  "viaUniversalResolver": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/justaname-ens-enrich-7d8ca91e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.justaname.id](https://www.zero.xyz/host/api.justaname.id/llms.txt)