GET/v1/whois/{domain}
Snapshot-first parsed WHOIS: registrar, statuses, events, nameservers, and redacted-as-received contacts. Serves a stored snapshot (≤30 days) unless `?live=true` forces an upstream refresh. Raw upstream text is never returned.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
| domain | path | yes | The domain to look up, e.g. `example.com`. A subdomain is resolved to its registrable domain (`www.example.com` → `example.com`). |
| live | query | no | Set to `true` to force a fresh upstream lookup (bounded by a 1-hour floor). Starter-only — a free key is denied with `plan_required`. Any other value is a normal snapshot lookup. |
Example response
{
"domain": "example.com",
"registrar": "Example Registrar, Inc.",
"whois_server": "whois.example-registrar.com",
"referral_url": "https://example-registrar.com",
"statuses": [
"clientTransferProhibited"
],
"snapshot_time": "2026-07-30T12:00:00.000Z",
"events": [
{
"event_action": "registration",
"event_date": "2003-01-01T00:00:00.000Z"
},
{
"event_action": "expiration",
"event_date": "2027-01-01T00:00:00.000Z"
}
],
"nameservers": [
{
"ldh_name": "ns1.example.com"
},
{
"ldh_name": "ns2.example.com"
}
],
"contacts": {
"registrant": {
"organization": "Acme",
"state_province": "CA",
"country": "US",
"email": "jane@acme.test"
}
}
}Errors
invalid_domain (400) · unauthorized (401) · domain_not_available (404) · rate_limited (429) · quota_exceeded (429) · service_unavailable (503) · plan_required (403) · not_found (404) · upstream_unavailable (502)