# WHOIS/RDAP Domain Lookup

> WHOIS/RDAP Domain Lookup is a paid API for AI agents from x402-micro-pay.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-20).

Looks up domain registration details (registrar, status, nameservers, dates, DNSSEC) via RDAP protocol for a given domain name

## Facts

- Endpoint: POST https://x402-micro-pay.com/api/skills/whois-rdap?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/whois-rdap-domain-lookup-12793a41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H4rgHFcYonu4t2LxA9R-_

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 whois-rdap-domain-lookup-12793a41 -d '<json body>'
```

Example prompt: Can you look up the WHOIS registration details for example.com — I want to know the registrar, registration date, current status, and nameservers?

## When to prefer this

Use this endpoint when you need structured, machine-readable domain registration data (registrar, dates, status, nameservers) without setting up an API key or account. Prefer over raw WHOIS text parsing since RDAP returns clean JSON with standardized fields. Ideal for one-off or low-volume lookups by AI agents where pay-per-call ($0.003) is more practical than a subscription. Choose over DNS-only lookups when registrar identity, domain status flags, or registration history are needed.

## Known failure modes

- Domain not found or not in RDAP registry — returns ok:false with error detail
- Invalid domain format (IP addresses not accepted) — schema validation error
- RDAP upstream timeout or registry unavailability — may return partial data or error
- TLD not supported by any known RDAP bootstrap entry — lookup fails gracefully
- Payment not made — HTTP 402 returned before data is delivered

## How this service works

41 pay-per-call JSON APIs for AI agents. No account or API key: an unpaid POST returns HTTP 402, pay in USDC on Base with x402 v2, retry. Prices from $0.001 per call.

## Output

A JSON object containing structured domain registration data including: registrar name, registration and last-changed timestamps, domain status codes (e.g. client hold, server delete prohibited), nameservers, DNSSEC status, registrant info (if available), RDAP conformance level, a human-readable summary string, confidence score, data sources with fetch timestamps, and suggested next skills (e.g. dns_lookup, email_check).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "domain": {
   "type": "string",
   "maxLength": 253,
   "minLength": 1,
   "description": "Domain name to look up (hostname, not an IP)"
  },
  "request_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9._:-]+$",
   "maxLength": 64,
   "minLength": 1,
   "description": "Optional idempotency key. Echoed back; a credit-pack redemption with the same request_id and body is charged once."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "as_of": "2026-10-26T14:00:00Z",
   "domain": "example.com",
   "events": {
    "last changed": "2024-08-14T07:01:38Z",
    "registration": "1995-08-14T04:00:00Z"
   },
   "handle": "example.com",
   "status": [
    "client hold",
    "server delete prohibited"
   ],
   "ldh_name": "example.com",
   "registrar": "RESERVED-Internet Assigned Numbers Authority",
   "registrant": null,
   "secure_dns": false,
   "nameservers": [
    "a.iana-servers.net",
    "b.iana-servers.net"
   ],
   "rdap_conformance": [
    "rdap_level_0"
   ]
  },
  "next": [
   "dns_lookup",
   "email_check"
  ],
  "skill": "whois_rdap",
  "charged": true,
  "service": "whois_rdap",
  "sources": [
   {
    "url": "https://data.iana.org/rdap/dns.json",
    "name": "IANA RDAP bootstrap",
    "fetched_at": "2026-10-26T14:00:00Z"
   },
   {
    "url": "https://rdap.verisign.com/com/v1/domain/example.com",
    "name": "RDAP",
    "fetched_at": "2026-10-26T14:00:00Z"
   }
  ],
  "summary": "example.com registrar=RESERVED-Internet Assigned Numbers Authority ns=2 status=client hold",
  "version": "1.0.0",
  "warnings": [],
  "confidence": 0.9,
  "data_as_of": "2026-10-26T14:00:00Z",
  "generated_at": "2026-10-26T14:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/whois-rdap-domain-lookup-12793a41/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-micro-pay.com](https://www.zero.xyz/host/x402-micro-pay.com/llms.txt)
