$ man domain-availability
/domain-availability(1)
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
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.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| domain | string | Domain to check (e.g. 'example.com'). Strip protocol/path automatically. | required |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| domain | string | Domain name that was queried, echoed back in lowercase canonical form. |
| is_registered | string | Boolean indicating whether the domain has an active RDAP record; false when rdap.org returns 404. |
| registrar | string | Sponsoring registrar name from the RDAP record, or null if not disclosed by the registry. |
| status | string | Array of EPP status codes currently set on the domain, like clientTransferProhibited or pendingDelete. |
| registered_date | string | Original registration timestamp from the RDAP events array, in ISO 8601 format. |
| expires_date | string | Current expiration timestamp from the RDAP events array, in ISO 8601 format. |
| last_changed | string | Most recent modification timestamp from the RDAP events array, in ISO 8601 format. |
| days_until_expiry | string | Integer days between now and expires_date; negative if the domain has already expired. |
| source | string | Upstream data source identifier, typically rdap.org indicating which RDAP aggregator answered. |
EXAMPLES — two 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
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| disposable-email-check | Disposable email detector / fake email filter / fraud signup defense. | $0.005 |
| github-stars-history | GitHub stars history / star growth chart / repo popularity over time / trending tracker. | $0.005 |
| link-extract | Link extractor / extract links from URL / list all anchor links / page outlink crawler / scrape outbound links / get hrefs from page. | $0.005 |
| mcp-tools-list | MCP tools-list / Model Context Protocol discovery / list MCP server tools / tools/list JSON-RPC / agent capability discovery / MCP catalo… | $0.005 |
| sitemap-fetch | Sitemap fetcher / sitemap.xml parser / sitemap index resolver / SEO sitemap reader / robots.txt sitemap discovery / website URL inventory. | $0.005 |
| wikipedia | Wikipedia API / encyclopedia lookup. | $0.005 |
| wikipedia-lookup | Wikipedia API / encyclopedia lookup / structured article fetch. | $0.005 |
| homoglyph-check | Homoglyph attack detector / Unicode lookalike scanner. | $0.003 |
SEE ALSO