# StatePulse WHOIS Lookup

> StatePulse WHOIS Lookup is a paid API for AI agents from statepulse-api.hahavoid0.workers.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-14).

Performs a WHOIS lookup for a given domain name, returning registration status, registrar, creation date, and expiry date.

## Facts

- Endpoint: POST https://statepulse-api.hahavoid0.workers.dev/network/whois
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/statepulse-whois-lookup-f8d08636
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TfA0xEUIZ2wkWNgQxCpEm

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 statepulse-whois-lookup-f8d08636 -d '<json body>'
```

Example prompt: Can you do a WHOIS lookup on openai.com and tell me who the registrar is, when it was created, and when it expires?

## When to prefer this

Use this endpoint when you need programmatic, pay-per-call WHOIS lookups without managing API keys, especially in agentic workflows that require domain registration details like registrar, creation date, or expiry date. Prefer this over manual WHOIS tools when automation and structured JSON output are required.

## Known failure modes

- Domain TLD not supported — 'supported' field returns false with no registration data
- Domain not found or unregistered — empty or null result fields
- Network timeout querying upstream WHOIS servers
- Invalid domain format in request body causing a 400-class error
- WHOIS rate limiting from upstream registrars causing degraded confidence or partial data

## How this service works

Queries the global RDAP bootstrap directory for domain registration details, registrar name, creation date, and expiration timestamp. Matches: domain registration checker, WHOIS lookup tool, check domain owner registry, check website expiry date.

## Output

Returns a JSON object with the domain's registration status (e.g. 'active'), registrar name (e.g. 'MarkMonitor Inc.'), creation date, expiration date, a 'supported' boolean indicating whether WHOIS data is available for that TLD, and a confidence level (e.g. 'high').

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "domain": "google.com",
   "status": [
    "active"
   ],
   "registrar": "MarkMonitor Inc.",
   "created_date": "1997-09-15T04:00:00Z",
   "expires_date": "2028-09-14T04:00:00Z"
  },
  "supported": true,
  "confidence": "high"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/statepulse-whois-lookup-f8d08636/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from statepulse-api.hahavoid0.workers.dev](https://www.zero.xyz/host/statepulse-api.hahavoid0.workers.dev/llms.txt)