Domain Expiry
When a domain's registration expires and how many whole days remain, read live from the authoritative registry RDAP server.
Example answer
When does this domain expire?
GET /v1/domains/eckari.com/expiry
- 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
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
ASCII (punycode) domain name as recorded by the registry.
True when the registry returned a record; false when the registry has no record.
Registry expiry date (RDAP expiration event); null when the registry does not publish one.
Whole days from now to expires_at, floored; negative when already past expiry.
RFC 9083 status values (the RDAP spelling of EPP status codes), lower-cased and sorted.
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.