Domain WHOIS (RDAP)

Registrar, creation and expiry dates, status and nameservers from the official RDAP server.

Domain registration lookup via RDAP (the official whois successor, IANA bootstrap): registered or not, registrar + IANA id + abuse email, created / updated / expiry dates, days to expiry, domain age, EPP status codes, nameservers, DNSSEC. Use it to vet a domain or check expiry.

$0.005 per call in USDC on Base via x402, or pay by card with prepaid credits (5 credits) · 1 free call per caller · no signup · Listed on PayAPI Market (this route is not PayAPI-verified yet; 7 other routes are, each by one settled test payment)

GET https://freetier-agent-api.pages.dev/api/domain-whois

When to use it

Use domain-whois to see who registered a domain, when it was created and when it expires (RDAP, official registry data).

Parameters

Name	Type	Description
`domain` required	string	domain, e.g. example.com (subdomains are reduced to the registered domain)

Example output (real response, trimmed)

{
 "domain": "example.com",
 "registered": true,
 "handle": "2336799_DOMAIN_COM-VRSN",
 "registrar": {
  "name": "RESERVED-Internet Assigned Numbers Authority",
  "iana_id": "376",
  "abuse_email": null
 },
 "created": "1995-08-14T04:00:00Z",
 "updated": "2026-08-14T08:01:43Z",
 "expires": "2027-08-13T04:00:00Z",
 "days_to_expiry": 291,
 "age_days": 11395,
 "status": [
  "client delete prohibited",
  "client transfer prohibited"
 ],
 "nameservers": [
  "elliott.ns.cloudflare.com",
  "hera.ns.cloudflare.com"
 ],
 "dnssec": true,
 "registrant": null,
 "rdap_server": "rdap.verisign.com",
 "checked_at": "2026-10-25T22:37:38.392Z",
 "sources": [
  {
   "name": "IANA RDAP bootstrap + registry RDAP (rdap.verisign.com)",
   "url": "https://rdap.verisign.com/com/v1/domain/example.com"
  }
 ]
}

Try it

Free call (no wallet needed)

curl -s "https://freetier-agent-api.pages.dev/api/domain-whois?domain=example.com"

Pay by card (no wallet): prepaid credits

Buy a credit pack on Gumroad (1,000 credits $3), then send your license key. The X-Credits-Remaining response header shows your balance; failed calls are not charged.

curl -s "https://freetier-agent-api.pages.dev/api/domain-whois?domain=example.com" \
  -H 'X-License-Key: YOUR-LICENSE-KEY'

JavaScript / TypeScript (@x402/fetch)

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY); // wallet with USDC on Base
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});
const res = await fetchWithPayment("https://freetier-agent-api.pages.dev/api/domain-whois?domain=example.com");
console.log(await res.json());

Python (x402 + httpx)

# pip install "x402[httpx,evm]" eth-account
import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client()
    register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))
    async with x402HttpxClient(client) as http:
        r = await http.get("https://freetier-agent-api.pages.dev/api/domain-whois?domain=example.com")
        print(r.json())

asyncio.run(main())

A bare request without parameters returns the HTTP 402 payment challenge (x402 v2 in the PAYMENT-REQUIRED header, v1 in the body). Invalid input gets a 400 before any payment.

Billing policy

Failed calls are never charged. Failed calls are never charged: the payment is verified first, the request runs, and the payment is settled only if it succeeded. Errors (4xx/5xx) are not settled, and invalid input is rejected before any payment or free call.

Uptime and latency

Independent monitoring of this endpoint: 402index service page (health, 30-day uptime, p50 latency).

Also available as

MCP tool domain_whois at https://freetier-agent-api.pages.dev/mcp (Streamable HTTP; in-band x402 payment via _meta["x402/payment"], or card credits via the X-License-Key header)
OpenAPI 3.1 with the full output JSON Schema

Agent Extraction API by FreeTier Kits · Terms · llms.txt · /.well-known/x402 · MCP: https://freetier-agent-api.pages.dev/mcp · Contact: tec@mail.grokbot.com
This site and its texts were written with AI assistance and reviewed for accuracy; example outputs are real responses from the API.