# Bulk WHOIS Lookup

> Bulk WHOIS Lookup is a paid API for AI agents from dns.use.x402atlas.com, paid per call via x402, $0.035/call, status unknown (last checked 2026-10-13).

Looks up registrar, creation/expiry dates, status, and nameservers for up to 10 domains in a single batch call, returning structured JSON.

## Facts

- Endpoint: GET https://dns.use.x402atlas.com/whois-bulk?utm_source=zero.xyz
- Price: $0.035/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bulk-whois-lookup-a4d40b0b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dIbgdMEVdzsCeR59Kw_Uh

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 bulk-whois-lookup-a4d40b0b
```

Example prompt: Can you pull WHOIS records for these 10 domains all at once — google.com, amazon.com, openai.com, anthropic.com, stripe.com, vercel.com, cloudflare.com, github.com, notion.so, linear.app — and give me their registrars, creation dates, expiry dates, and nameservers in a structured list?

## When to prefer this

Choose this endpoint when you need to look up WHOIS registration data for multiple domains in a single operation (up to 10). It is more cost- and latency-efficient than making individual WHOIS calls per domain. Prefer this over the single-domain WHOIS endpoint when auditing domain portfolios, monitoring expiry dates across a set of domains, or running brand-protection checks against a list of potentially squatted names. If you need raw WHOIS text rather than parsed structured JSON, use the single-domain WHOIS endpoint instead. If you need RDAP-formatted data, use the RDAP sibling endpoint.

## Known failure modes

- Individual domain not found — entry returns error code 'not_found' with a message
- Upstream WHOIS registry timeout — entry returns error code 'timeout'
- Upstream registry error — entry returns error code 'upstream_error'
- More than 10 domains submitted — request rejected or truncated
- Malformed domain names in the comma-separated list — may result in not_found or upstream_error per entry
- WHOIS data unavailable for some TLDs — registrar or dates may be empty strings

## How this service works

Bulk WHOIS lookup: registrar, creation/expiry dates, status and nameservers for up to 10 domains in a single batch call, parsed into structured JSON. One payment per batch — for domain portfolio audits, expiry monitoring and brand-protection checks.

## Output

Returns a JSON object containing the queried domain list, a timestamp, and one result entry per domain with fields: registrar name, creation/updated/expiration dates (RFC3339), EPP status codes array, nameservers array, and domain age in days. If an individual domain lookup fails, that entry includes an error object with a code (not_found, upstream_error, or timeout) and message, while other domains in the batch remain unaffected.

## 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": [
      "domains"
     ],
     "properties": {
      "domains": {
       "type": "string",
       "maxLength": 2600,
       "minLength": 1,
       "description": "Comma-separated list of up to 10 domain names"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "results",
      "queried_at"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "The domains list that was looked up"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "domain",
         "registrar",
         "created",
         "updated",
         "expiration",
         "status",
         "nameservers",
         "domain_age_days"
        ],
        "properties": {
         "error": {
          "type": "object",
          "required": [
           "code",
           "message"
          ],
          "properties": {
           "code": {
            "enum": [
             "not_found",
             "upstream_error",
             "timeout"
            ],
            "type": "string"
           },
           "message": {
            "type": "string"
           }
          },
          "description": "Only when this domain's lookup failed; others are unaffected"
         },
         "domain": {
          "type": "string"
         },
         "status": {
          "type": "array",
          "items": {
           "type": "string"
          },
          "description": "EPP status codes"
         },
         "created": {
          "type": "string",
          "description": "RFC3339; empty if unavailable"
         },
         "updated": {
          "type": "string",
          "description": "RFC3339; empty if unavailable"
         },
         "registrar": {
          "type": "string",
          "description": "Empty if unavailable"
         },
     
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bulk-whois-lookup-a4d40b0b/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)