# fetchx402 WHOIS / RDAP Domain Lookup

> fetchx402 WHOIS / RDAP Domain Lookup is a paid API for AI agents from api.fetchx402.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns live RDAP-based domain registration facts (registrar, status, dates, nameservers, DNSSEC) for a given fully-qualified domain name.

## Facts

- Endpoint: GET https://api.fetchx402.com/v1/tools/whois
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fetchx402-whois-rdap-domain-lookup-a8ad69d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sN69mfS60_bWJE1_n5fno

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 fetchx402-whois-rdap-domain-lookup-a8ad69d1
```

Example prompt: Can you look up the live RDAP registration details for stripe.com — I need the registrar, registration and expiry dates, nameservers, and whether DNSSEC is enabled?

## When to prefer this

Choose this endpoint when you need authoritative, live domain registration facts from the official RDAP registry — not cached WHOIS snapshots. It is the right choice when you must confirm registration status, expiry, registrar identity, nameserver delegation, or DNSSEC without guessing. Prefer it over DNS-only lookups when the question is about ownership and registration lifecycle rather than DNS resolution. For a single-call bundle of DNS + TLS + RDAP facts, consider the sibling all-in-one endpoint instead.

## Known failure modes

- Domain not registered — returns not_found rather than an error
- Invalid or non-public domain (IP address, localhost, mDNS name) — rejected with an error
- RDAP registry unavailable for the TLD — may return a timeout or incomplete data
- Malformed domain string (missing TLD, special characters) — rejected at input validation
- Payment failure (x402 protocol) — call not executed, no data returned

## How this service works

Look up domain registration facts via RDAP (registrar, status, dates, nameservers, DNSSEC). Use when you need live registry data and must not guess. Unregistered names return not_found.

## Output

A structured RDAP record containing: registrar name, domain status flags (e.g. clientTransferProhibited), creation/updated/expiration dates, nameserver hostnames, DNSSEC delegation status, and registry identifiers. If the domain is not registered, returns a not_found result rather than guessing.

## 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"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "domain"
     ],
     "properties": {
      "domain": {
       "type": "string",
       "description": "Public fully-qualified domain name to look up, such as example.com. IPs, localhost, and internal/mDNS names are rejected."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "dnssec": true,
  "domain": "example.com",
  "handle": "2336799_DOMAIN_COM-VRSN",
  "source": "rdap",
  "status": [
   "client delete prohibited",
   "client transfer prohibited",
   "client update prohibited"
  ],
  "registrar": {
   "name": "RESERVED-Internet Assigned Numbers Authority",
   "iana_id": "376"
  },
  "created_at": "1995-08-14T04:00:00Z",
  "expires_at": "2025-08-13T04:00:00Z",
  "updated_at": "2024-08-14T07:01:39Z",
  "nameservers": [
   "a.iana-servers.net",
   "b.iana-servers.net"
  ],
  "rdap_server": "https://rdap.verisign.com/com/v1/"
 }
}
```

## More

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