Domain Registration (RDAP)

What It Does

Queries RDAP servers (RFC 7480, RFC 9224 bootstrap) to retrieve domain registration metadata including registrar name, IANA accreditation ID, and URL; registration dates (created, updated, expires) with computed domain age in days, newly-registered flag (< 30 days), days until expiry, and expiring-soon flag (< 30 days); EPP status codes (clientTransferProhibited, serverHold, redemptionPeriod, etc.); authoritative nameservers; DNSSEC signing status; and registrant, administrative, and technical contacts. Detects privacy-proxy registrants (WhoisGuard, PrivacyGuardian, Withheld for Privacy, Domains By Proxy, Cloudflare Registrar, etc.) and surfaces a `contacts.redacted` flag with `redaction_reason` when GDPR / ICANN privacy policy suppresses identifying fields, so compliance reports can distinguish "redacted" from "missing data". Enriches the registrar against the IANA registrar registry — `registrar.is_accredited` and `registrar.country` derive from a curated subset of the official IANA Registrar IDs assignment. For ccTLDs without RDAP support, falls back to legacy WHOIS over TCP port 43 (RFC 3912) and surfaces the protocol used via the `protocol` field. Optionally returns the raw upstream response via include_raw.

Why It's Useful

ICANN officially sunsetted WHOIS for gTLDs on 28 January 2025 — RDAP is now the canonical source for gTLD registration data, and EdgeDNS handles bootstrap discovery automatically. Privacy-proxy detection and GDPR-redaction transparency give fraud and threat-intel teams the context they need to triage "newly-registered + privacy-shielded + sketchy nameservers" patterns without writing those heuristics themselves. The port-43 fallback covers the long tail of ccTLDs (.de, .it, .br, .au, .nz, .jp, etc.) where RDAP coverage is partial, so callers don't silently 5xx on otherwise-valid domains.

Use Cases

Parameters

Response Fields

Code Examples

curl "https://api.edgedns.dev/v1/domain/whois" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=example.com"

const response = await fetch(
  'https://api.edgedns.dev/v1/domain/whois?domain=example.com',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.edgedns.dev/v1/domain/whois',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'domain': 'example.com'
    }
)

data = response.json()
print(data)

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.