Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man whois

/whois

PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobe
CATEGORY
utilities
STATUS
live
NAME
whois looks up a domain's whois/rdap registration record: age, expiry, registrar, and nameservers
SYNOPSIS
POST https://x402.agentutility.ai/whois
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Looks up a domain's WHOIS/RDAP registration record: age, expiry, registrar, and nameservers. Short alias of whois-lookup; queries the IANA-mandated RDAP endpoint and returns registered_date, age_days, expiration_date, days_until_expiry, last_changed, registrar (name + IANA id), contacts, nameservers, dnssec_signed, EPP statuses, and risk flags, optionally appending a crt.sh certificate-transparency summary. Use it for domain age and domain expiry checks, as a registrar finder, nameserver lookup, DNSSEC check, TLD registration record, or brand-protection triage.

INPUTrequest schema
propertytypedescriptionreq?
domainstringApex domain to look up (e.g. 'example.com'). Subdomains are stripped to the registrable domain.required
include_certificatesbooleanIf true, attaches a crt.sh certificate-transparency summary. Default false.optional
OUTPUTresponse shape
fieldtypedescription
domainstringQueried domain name in canonical form (lowercased, punycode for IDNs).
rdap_serverstringRDAP service URL that answered the query, or the WHOIS host if RDAP was unavailable.
registered_datestringDomain creation date in ISO 8601 (UTC) as reported by the registry.
expiration_datestringDomain expiration date in ISO 8601 (UTC) as reported by the registry.
age_daysnumberDays elapsed since the registered_date, rounded down.
days_until_expirynumberDays remaining until expiration_date; negative if already expired.
registrarobjectRegistrar record with name, IANA ID, abuse contact email, and URL.
contactsobjectRegistrant, admin, and tech contact handles with any fields the registry exposes (often redacted).
nameserversarrayAuthoritative nameserver hostnames listed at the registry for the domain.
dnssec_signedbooleanTrue if the registry reports a signed delegation (DS records present) for the domain.
statusesarrayEPP status codes from the registry (clientTransferProhibited, serverHold, pendingDelete, etc.).
flagsarrayDerived risk flags such as newly_registered, expiring_soon, redacted_contacts, or locked.
cert_summaryobjectTLS certificate snapshot for the apex: issuer, notBefore, notAfter, SANs count, days_to_expiry.
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/whois \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the whois tool from your MCP-aware agent.
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
ADJACENTother endpoints in webprobe
endpointdescriptionprice
archive-snapshotFinds the closest archived snapshot of a public URL, like a Wayback Machine API.$0.02
archive-snapshot-apiFinds archived snapshots of public web pages, returning the closest Wayback Machine captures with timestamps, status codes, and replay URLs.$0.02
archive-urlLooks up the archived copy of a public URL closest to a given timestamp and can fetch cleaned archived page text.$0.02
brand-domain-checkChecks whether a brand or company domain is established, expiring, registrar-locked, or newly registered, on the same RDAP backend as who…$0.02
brand-watch-domain-riskChecks new or suspicious brand-adjacent domains for age, registrar, expiry, DNSSEC, and transfer/lock statuses.$0.02
creator-domain-checkChecks creator, newsletter, podcast, and community domains for age, expiry, registrar, DNSSEC, and suspicious new-registration flags.$0.02
dmarc-checkAudits a domain's email authentication posture: DMARC, SPF, and DKIM in one check.$0.02
dns-lookupFull DNS lookup over Cloudflare 1.1.1.1 DNS-over-HTTPS.$0.02
SEE ALSO
agentutility · webprobe · x402 · mcp · llms.txt · registry.json · bazaar.x402.org