Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man domain-availability

/domain-availability(1)

agentutility / web-probe / domain-availability
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobe
CATEGORY
uncategorized
STATUS
live
NAME
domain-availability domain availability / rdap lookup / whois replacement / domain registration checker / expiry date lookup
SYNOPSIS
POST https://x402.org/v1/domain-availability
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

Domain availability / RDAP lookup / WHOIS replacement / domain registration checker / expiry date lookup. Returns is_registered, registrar, registration date, expiry date, days_until_expiry, and current EPP status flags for any TLD that supports RDAP (effectively all gTLDs and most ccTLDs). Backed by rdap.org, the public RFC-7480-compliant aggregator. 404s map to is_registered: false rather than an error.

INPUTrequest schema
propertytypedescriptionreq?
domainstringDomain to check (e.g. 'example.com'). Strip protocol/path automatically.required
OUTPUTresponse shape
fieldtypedescription
domainstringDomain name that was queried, echoed back in lowercase canonical form.
is_registeredstringBoolean indicating whether the domain has an active RDAP record; false when rdap.org returns 404.
registrarstringSponsoring registrar name from the RDAP record, or null if not disclosed by the registry.
statusstringArray of EPP status codes currently set on the domain, like clientTransferProhibited or pendingDelete.
registered_datestringOriginal registration timestamp from the RDAP events array, in ISO 8601 format.
expires_datestringCurrent expiration timestamp from the RDAP events array, in ISO 8601 format.
last_changedstringMost recent modification timestamp from the RDAP events array, in ISO 8601 format.
days_until_expirystringInteger days between now and expires_date; negative if the domain has already expired.
sourcestringUpstream data source identifier, typically rdap.org indicating which RDAP aggregator answered.
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/domain-availability \
  -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 domain-availability tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
web-probedomain-availabilityrdapwhoisdomain-lookupdomain-expiryregistrar-lookup
methods
POST
cluster
webprobe
price
$0.005 USDC per call
ADJACENTother endpoints in webprobe
endpointdescriptionprice
disposable-email-checkDisposable email detector / fake email filter / fraud signup defense.$0.005
github-stars-historyGitHub stars history / star growth chart / repo popularity over time / trending tracker.$0.005
link-extractLink extractor / extract links from URL / list all anchor links / page outlink crawler / scrape outbound links / get hrefs from page.$0.005
mcp-tools-listMCP tools-list / Model Context Protocol discovery / list MCP server tools / tools/list JSON-RPC / agent capability discovery / MCP catalo…$0.005
sitemap-fetchSitemap fetcher / sitemap.xml parser / sitemap index resolver / SEO sitemap reader / robots.txt sitemap discovery / website URL inventory.$0.005
wikipediaWikipedia API / encyclopedia lookup.$0.005
wikipedia-lookupWikipedia API / encyclopedia lookup / structured article fetch.$0.005
homoglyph-checkHomoglyph attack detector / Unicode lookalike scanner.$0.003
SEE ALSO
agentutility(7) · webprobe(7) · x402(7) · mcp(7) · llms.txt · registry.json · bazaar.x402.org