$ man whois-lookup
/whois-lookup(1)
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
utilities
STATUS
● live
NAME
whois-lookup — whois / rdap domain lookup
SYNOPSIS
POST https://x402.org/v1/whois-lookup
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
WHOIS / RDAP domain lookup. Registration date, age, expiration, registrar, contacts, nameservers, DNSSEC, status flags, transfer history. Optional certificate-transparency summary.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| domain | string | Apex domain to look up (e.g. 'example.com'). Subdomains are stripped to the registrable domain before query. | required |
| include_certificates | boolean | If true, fetch a crt.sh certificate-transparency summary (issuer counts, first/last seen, total certs). Default false. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| domain | string | Queried domain name in canonical lowercase form. |
| rdap_server | string | RDAP server URL that answered the lookup for this TLD. |
| registered_date | string | Domain creation timestamp in ISO 8601 format. |
| expiration_date | string | Current registration expiration timestamp in ISO 8601 format. |
| age_days | number | Days elapsed since the domain was first registered. |
| days_until_expiry | number | Days remaining until the current registration expires; negative if already expired. |
| registrar | object | Registrar record with name, IANA ID, and abuse contact email and phone. |
| contacts | object | Registrant, admin, and tech contact roles with any unredacted name, org, email, and country. |
| nameservers | array | Authoritative nameserver hostnames listed on the domain record. |
| dnssec_signed | boolean | True if the domain has a signed DNSSEC delegation at the TLD. |
| statuses | array | EPP status codes on the domain such as clientTransferProhibited or pendingDelete. |
| flags | array | Derived risk flags like newly-registered, expiring-soon, redacted-whois, or pending-transfer. |
| cert_summary | object | Certificate-transparency summary with first-seen date, recent issuers, and active cert count. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/whois-lookup \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the whois-lookup tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- whoisrdapdomaindnssecurity
- methods
- POST
- cluster
- webprobe
- price
- $0.02 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| archive-snapshot | Wayback Machine API / archive.org wrapper. | $0.02 |
| dmarc-check | DMARC / SPF / DKIM checker. | $0.02 |
| dns-lookup | DNS lookup / DNS resolver / DoH proxy. | $0.02 |
| expand-url | URL expander / redirect chain tracer / link-shortener resolver. | $0.02 |
| password-strength | Password strength meter + breach checker. | $0.02 |
| whois | Domain WHOIS / RDAP lookup. | $0.02 |
| arxiv-search | arXiv full-text search. | $0.03 |
| ssl-cert | SSL certificate inspector / TLS cert checker / certificate transparency lookup / ssl expiry. | $0.03 |
SEE ALSO