Checking domain expiry and status codes
Status codes such as clientTransferProhibited and serverHold are machine-readable in RDAP. Reading them directly is how you confirm a registrar lock is actually in place.
Looks up registration data for a domain or IP via RDAP (the modern WHOIS).
Looks up registration data for a domain or IP via RDAP (the modern WHOIS).
example.com
Registrar, registration/expiry dates, nameservers, status codes
RDAP is the structured replacement for WHOIS.
The data describes the domain's registration, not its content.
Your input is sent to YAS infrastructure because the tool requires server-side processing or public network queries. Input is not stored.
curl -X POST "https://yas.sh/api/v1/tools/rdap-lookup" \
-H "Content-Type: application/json" \
-d '{"domain":"example.com"}'const res = await fetch("https://yas.sh/api/v1/tools/rdap-lookup", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"domain": "example.com"
}),
});
const data = await res.json();import requests
r = requests.post("https://yas.sh/api/v1/tools/rdap-lookup", json={"domain":"example.com"})
data = r.json()| Field | Type | Required | Description |
|---|---|---|---|
| domain | string | Yes | Domain, e.g. example.com |
{ "domain": "example.com", "registrar": "RESERVED-Internet Assigned Numbers Authority", "creationDate": "...", "expiry": "...", "nameservers": [...] }Registry data for a domain via RDAP (registrar, dates, nameservers).
400 VALIDATION_ERROR — invalid input or unsupported option.413 PAYLOAD_TOO_LARGE — input exceeds the 64 KB limit.429 RATE_LIMIT_EXCEEDED — rate limit exceeded (60 req/min).RDAP is the JSON-over-HTTPS successor to WHOIS, standardised in RFC 7480–7484. Instead of an unstructured text blob that every registry formats differently, RDAP returns typed objects with defined members: events (registration, expiry, last changed), status codes, nameservers, entities with roles, and vCard-formatted contact data. Because it runs over HTTPS with normal HTTP semantics, it supports proper redirects, error codes and referrals.
Lookups follow a bootstrap process: the IANA registry maps a TLD or an address block to its authoritative RDAP server, and the client follows referrals from registry to registrar for the detailed record. That structure is what makes RDAP programmatically usable, whereas WHOIS parsing requires per-registry heuristics that break whenever a registry changes its output.
Status codes such as clientTransferProhibited and serverHold are machine-readable in RDAP. Reading them directly is how you confirm a registrar lock is actually in place.
Abuse handling needs the network's abuse contact, which RDAP exposes as a typed entity role rather than buried in free text.
Structured expiry events make automated renewal alerting reliable, without regex parsing of registry-specific WHOIS text.
Registration date and status are strong signals: a domain registered days ago and used in email is worth treating differently from one registered a decade ago.
What this tool deliberately does not do, and where it will disagree with other implementations.
Registry data via RDAP — registrar, dates, nameservers.