Skip to content
Gridlode
Docs · Reference

RDAP Lookup

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

Structured registration data for a domain from its registry's RDAP server: registrar, creation/expiry dates, status codes, nameservers and DNSSEC. Personal registrant data is never returned.

Query parameters

domain
string · required
Domain to look up, e.g. example.com. URLs and subdomains are reduced to the registrable domain.
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

  • domain · Normalized registrable domain (punycode for IDNs).
  • registered · false when the registry has no record (the domain is unregistered).
  • registrar · name, iana_id, abuse_email, abuse_phone of the sponsoring registrar.
  • registrant · Organization and country only when published and not redacted. Never personal names or emails.
  • dates · registered, expires, updated, rdap_database_updated (ISO 8601).
  • age_days · Days since registration.
  • status · EPP status codes, e.g. client transfer prohibited.
  • nameservers · Lowercase name server hostnames.
  • dnssec · true when the delegation is signed.
  • rdap_server / registrar_rdap_url · The registry server we queried and the registrar's RDAP link when given.

Example

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

Try it without code on the RDAP Lookup API page.