domain.registration

Domain Registration Record

The registry-level record for a domain: registrar, status codes, creation and expiry dates, nameservers and DNSSEC signing. Registrant contacts are redacted by registries.

Example answer

Ask

Who is the registrar of this domain and when does it expire?

GET /v1/domains/example.com/registration

Eckari

{
  "domain": "example.com",
  "unicode_name": null,
  "tld": "com",
  "bootstrap_suffix": "com",
  "is_registered": true,
  "status": [
    "client delete prohibited",
    "client transfer prohibited",
    "client update prohibited"
  ],
  "registrar": {
    "name": "RESERVED-Internet Assigned Numbers Authority",
    "iana_id": "376",
    "url": null,
    "abuse_email": null
  },
  "events": {
    "registered_at": "1995-08-14T04:00:00.000Z",
    "updated_at": "2026-08-14T08:01:43.000Z",
    "expires_at": "2027-08-13T04:00:00.000Z",
    "transferred_at": null
  },
  "nameservers": [
    "elliott.ns.cloudflare.com",
    "hera.ns.cloudflare.com"
  ],
  "dnssec_signed": true,
  "rdap_server": "https://rdap.verisign.com/com/v1/",
  "rdap_last_update": "2026-08-18T16:09:14.000Z",
  "days_until_expiry": 359,
  "auto_renew_flag": null,
  "terms_url": "https://www.verisign.com/domain-names/registration-data-access-protocol/terms-service/index.xhtml",
  "availability_note": null
}

Source: Registry RDAP
Freshness: Near live
Price: $0.004

Version: 2.1.0
Transport: HTTP / MCP
Coverage: Global

Use this when

Answer a WHOIS question about a domain - registrar, creation date, expiry, transfer lock - from the registry record.
Who is the registrar of this domain and when does it expire?
You want a WHOIS lookup - this is the same question answered from RDAP, the registries' own structured replacement for it.
Is this domain registered, and when was it created?
You need the registry status codes such as "client transfer prohibited" (the RDAP spelling of the EPP code clientTransferProhibited) before a transfer.
You need nameservers and DNSSEC status from the registry rather than DNS.

Don't use this when

You only need the expiry date and days remaining - use domain.expiry (cheaper).
You need registrant name, email, address or phone - registries redact them.
You need an authoritative availability check for purchase - use a registrar EPP check.
You need bulk or historical registration data or zone files - prohibited by registry terms.
The TLD has no RDAP service in the IANA bootstrap (returns UNSUPPORTED_REGION).

If the user has asked you to inspect a specific website, page or URL, use your browsing tool instead — this capability only returns the RDAP record.

Input

domainstringrequired

Bare domain name such as example.com or bbc.co.uk. Internationalised names are converted to punycode (IDNA). URLs, paths, ports and single-label names are rejected.

What the result means

domainstring

ASCII (punycode) domain name as recorded by the registry.

unicode_namestring, null

Unicode form of the name when the registry publishes one.

tldstring

Top-level domain - the last label of the name, lower-cased and without a dot (uk for bbc.co.uk, com for example.com). It is the label itself, not necessarily the suffix the IANA bootstrap matched, and not the registrable suffix (co.uk) - read bootstrap_suffix for the entry that actually routed the query.

bootstrap_suffixstring

Suffix that matched in the IANA RDAP bootstrap (RFC 9224 longest-suffix rule) and so selected rdap_server. Usually the same as tld, but it can be longer where IANA publishes a multi-label entry.

is_registeredboolean

True when the registry returned a record. False means the registry has no record (RDAP 404).

statusarray

RFC 9083 status values - the RDAP spelling of EPP status codes, so "client transfer prohibited" here is EPP clientTransferProhibited - lower-cased, de-duplicated and sorted.

Provenance

Source: Registry RDAP
Freshness: Near live · read at request time, not cached
Region: Global

Access

Over MCP: domain_registration
Over HTTP: GET https://api.eckari.com/v1/domains/{domain}/registration
Price: $0.004 per call over x402. Account access $0.003 when that rail opens.