When does this domain expire?

Expiry date, days remaining, whether it has already expired, status codes and the registrar. Handy for renewal reminders.

Request

GEThttps://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com
*
String. Domain name, e.g. github.com. A full URL is also accepted.
Language
Client
1curl --request GET \
2  --url 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com' \
3  --header 'Accept: application/json' \
4  --header 'X-API-Key: YOUR_API_KEY'

When does this domain expire?: WHOIS Domain Lookup API reference

Expiry date, days remaining, whether it has already expired, status codes and the registrar. Handy for renewal reminders. This endpoint is part of the WHOIS Domain Lookup API: Look up who registered a domain, when it expires, its name servers and age. Clean JSON, no HTML parsing.

Example response (200, application/json)

Success

1{
2  "domain": "github.com",
3  "status": [
4    "clientDeleteProhibited",
5    "clientTransferProhibited",
6    "clientUpdateProhibited"
7  ],
8  "expired": false,
9  "expires": "2028-10-09T18:20:50Z",
10  "registrar": "MarkMonitor Inc.",
11  "days_remaining": 696
12}

Errors

  • 400 — Pass a domain name such as apihiver.com (not an IP address).
    1{
    2  "error": {
    3    "code": "INVALID_INPUT",
    4    "message": "Pass a domain name such as apihiver.com (not an IP address)."
    5  }
    6}
  • 404 — No WHOIS record found. The domain may not be registered.
    1{
    2  "error": {
    3    "code": "NOT_FOUND",
    4    "message": "No WHOIS record found. The domain may not be registered."
    5  }
    6}
  • 422 — WHOIS data is not available for this domain extension.
    1{
    2  "error": {
    3    "code": "TLD_NOT_SUPPORTED",
    4    "message": "WHOIS data is not available for this domain extension."
    5  }
    6}

Gateway errors (missing key, no subscription, rate limits) are listed in Error codes.