← All capabilities
domain.expiry

Domain Expiry

When a domain's registration expires and how many whole days remain, read live from the authoritative registry RDAP server.

Example answer

Ask

When does this domain expire?

GET /v1/domains/eckari.com/expiry

Eckari
{
"domain": "eckari.com",
"is_registered": true,
"expires_at": "2027-08-17T08:03:38.000Z",
"days_until_expiry": 363,
"status": [
"client transfer prohibited"
],
"registrar_name": "NameCheap, Inc.",
"rdap_last_update": "2026-08-18T16:09:14.000Z",
"terms_url": "https://www.verisign.com/domain-names/registration-data-access-protocol/terms-service/index.xhtml"
}
Source
Registry RDAP
Freshness
Near live
Price
$0.002
Version
2.1.0
Transport
HTTP / MCP
Coverage
Global

Use this when

  • When does this domain expire?
  • How many days are left before this domain expires?
  • You are monitoring a domain portfolio for renewals.
  • You need to know whether a domain has lapsed or entered redemption or pending delete.
  • You need expiry plus registrar in one cheap call.

Don't use this when

  • You also need nameservers, DNSSEC, the creation date or the registrar's abuse contact - use domain.registration.
  • You need registrant contact details - registries redact them.
  • You need an authoritative availability or drop-catch signal - use a registrar EPP check.
  • 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.

is_registeredboolean

True when the registry returned a record; false when the registry has no record.

expires_atstring, null

Registry expiry date (RDAP expiration event); null when the registry does not publish one.

days_until_expiryinteger, null

Whole days from now to expires_at, floored; negative when already past expiry.

statusarray

RFC 9083 status values (the RDAP spelling of EPP status codes), lower-cased and sorted.

registrar_namestring, null

Registrar name from the RDAP registrar entity.

Provenance

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

Access

Over MCP
domain_expiry
Over HTTP
GET https://api.eckari.com/v1/domains/{domain}/expiry
Price
$0.002 per call over x402. Account access $0.0015 when that rail opens.
Domain Registration Recorddomain.registration

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