# WHOIS Domain Lookup

> WHOIS Domain Lookup is a paid API for AI agents from dns.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns authoritative WHOIS data for a domain including registrar, nameservers, creation/expiry/updated dates, and status flags.

## Facts

- Endpoint: GET https://dns.use.x402atlas.com/whois
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/whois-domain-lookup-0bf10462
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ta7iFHCrUYVlcpLutGz9T

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-domain-lookup-0bf10462
```

Example prompt: Can you pull the WHOIS record for openai.com? I want to know the registrar, nameservers, when it was created, and when it expires.

## When to prefer this

Use this endpoint when you need authoritative domain registration metadata such as registrar, nameservers, and lifecycle dates (creation, expiry, updated). Prefer this over DNS record lookups (A, MX, TXT) when the goal is ownership, registration status, or expiry information rather than DNS resolution. Ideal for domain due diligence, monitoring domain expiry, verifying domain ownership, or investigating suspicious domains.

## Known failure modes

- Domain not found or not registered — returns empty or error response
- WHOIS rate limiting by the authoritative registry — may return incomplete data
- Private/redacted WHOIS records (GDPR) — registrant details may be masked
- Invalid or malformed domain input — may return error or no data
- Registry temporarily unavailable — lookup fails with timeout or error

## How this service works

WHOIS domain lookup — raw registry text with registrar, nameservers, lifecycle dates and status, plus the responding server. Use the RDAP endpoint when you need parsed structured data.

## Output

A JSON object containing the domain's WHOIS record with registrar name, nameserver list, creation date, expiry date, last-updated date, domain status flags, and the raw authoritative registry response.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "domain"
     ],
     "properties": {
      "domain": {
       "type": "string",
       "maxLength": 253,
       "minLength": 1,
       "description": "Bare domain to query (not an IP literal, not localhost, not under a reserved suffix like .local/.internal)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "domain",
      "server",
      "raw",
      "queried_at"
     ],
     "properties": {
      "raw": {
       "type": "string",
       "description": "Unparsed WHOIS response text; format varies per TLD"
      },
      "domain": {
       "type": "string",
       "description": "The queried domain"
      },
      "server": {
       "type": "string",
       "description": "Authoritative WHOIS host whose raw text was returned (IANA if no referral)"
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "UTC timestamp of the lookup"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": "Domain Name: EXAMPLE.COM\n...",
  "domain": "example.com",
  "server": "whois.verisign-grs.com",
  "queried_at": "2026-06-05T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/whois-domain-lookup-0bf10462/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from dns.use.x402atlas.com](https://www.zero.xyz/host/dns.use.x402atlas.com/llms.txt)