Skip to content
Gridlode
Docs · Reference

WHOIS Lookup

GET /v1/domain/whois1 credit / requestcache 1440 min

Raw port-43 WHOIS text from the registry (and the registrar for thin registries such as .com) plus parsed registrar, dates, status and name servers. Personal emails and phone numbers are redacted by default.

Query parameters

domain
string · required
Domain to look up, e.g. example.com.
follow_referral
boolean
Also query the registrar's WHOIS server (thin registries like .com).
Default: true
redact_personal
boolean
Redact personal emails and phone numbers in the raw text.
Default: true
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

  • registered · Whether the registry reports a registration.
  • server / registrar_server · WHOIS servers queried (registry, then registrar for thin registries like .com).
  • parsed · registrar, created, expires, updated, name_servers, status extracted from the text.
  • raw / registrar_raw · Raw WHOIS text. Personal emails and phones are redacted unless redact_personal=false.

Example

curl "https://api.gridlode.com/v1/domain/whois?domain=example.com" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

Try it without code on the WHOIS Lookup API page.