agentutility(7)$ man whois
/whois
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
utilities
STATUS
● live
NAME
whois — whois api for agents, backed by the iana-mandated rdap endpoint
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
WHOIS API for agents, backed by the IANA-mandated RDAP endpoint. Returns domain age, registration and expiration dates, registrar, contacts, nameservers, DNSSEC status, EPP statuses, transfer history, and risk flags. This short alias of whois-lookup can also append a certificate-transparency summary. Use it for domain diligence, expiry monitoring, phishing triage, or registrar checks.
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. | required |
| include_certificates | boolean | If true, attaches a crt.sh certificate-transparency summary. Default false. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| domain | string | Queried domain name in canonical form (lowercased, punycode for IDNs). |
| rdap_server | string | RDAP service URL that answered the query, or the WHOIS host if RDAP was unavailable. |
| registered_date | string | Domain creation date in ISO 8601 (UTC) as reported by the registry. |
| expiration_date | string | Domain expiration date in ISO 8601 (UTC) as reported by the registry. |
| age_days | number | Days elapsed since the registered_date, rounded down. |
| days_until_expiry | number | Days remaining until expiration_date; negative if already expired. |
| registrar | object | Registrar record with name, IANA ID, abuse contact email, and URL. |
| contacts | object | Registrant, admin, and tech contact handles with any fields the registry exposes (often redacted). |
| nameservers | array | Authoritative nameserver hostnames listed at the registry for the domain. |
| dnssec_signed | boolean | True if the registry reports a signed delegation (DS records present) for the domain. |
| statuses | array | EPP status codes from the registry (clientTransferProhibited, serverHold, pendingDelete, etc.). |
| flags | array | Derived risk flags such as newly_registered, expiring_soon, redacted_contacts, or locked. |
| cert_summary | object | TLS certificate snapshot for the apex: issuer, notBefore, notAfter, SANs count, days_to_expiry. |
EXAMPLES — two 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.005 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| arxiv-bibtex | Turns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma… | $0.005 |
| brand-domain-check | Checks whether a brand or company domain is established, expiring, registrar-locked, or newly registered, on the same RDAP backend as who… | $0.005 |
| brand-name-score | Scores a candidate brand or startup name on quality and risk. | $0.005 |
| brand-watch-domain-risk | Checks new or suspicious brand-adjacent domains for age, registrar, expiry, DNSSEC, and transfer/lock statuses. | $0.005 |
| company-name-score | Scores the quality of a company name before you commit to domain, handle, trademark, and launch work. | $0.005 |
| creator-domain-check | Checks creator, newsletter, podcast, and community domains for age, expiry, registrar, DNSSEC, and suspicious new-registration flags. | $0.005 |
| crypto-headlines | Crypto headlines API for agents that need breaking cryptocurrency news by topic or query. | $0.005 |
| crypto-news | Crypto news API that searches recent cryptocurrency headlines for a topic, token, protocol, or market event. | $0.005 |
SEE ALSO