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.
When does this domain expire?: example requests in every language
GET /v1/expiry in Shell (cURL)
curl --request GET \
--url 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com' \
--header 'Accept: application/json' \
--header 'X-API-Key: YOUR_API_KEY'GET /v1/expiry in Shell (HTTPie)
http GET 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com' \
Accept:application/json \
X-API-Key:YOUR_API_KEYGET /v1/expiry in Shell (Wget)
wget --quiet \
--method GET \
--header 'Accept: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--output-document \
- 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com'GET /v1/expiry in Node.js (http)
const http = require('https');
const options = {
method: 'GET',
hostname: 'whois-domain-lookup.p.apihiver.com',
port: null,
path: '/v1/expiry?domain=github.com',
headers: {
Accept: 'application/json',
'X-API-Key': 'YOUR_API_KEY'
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on('data', function (chunk) {
chunks.push(chunk);
});
res.on('end', function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();GET /v1/expiry in Node.js (Request)
const request = require('request');
const options = {
method: 'GET',
url: 'https://whois-domain-lookup.p.apihiver.com/v1/expiry',
qs: {domain: 'github.com'},
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});GET /v1/expiry in Node.js (Unirest)
const unirest = require('unirest');
const req = unirest('GET', 'https://whois-domain-lookup.p.apihiver.com/v1/expiry');
req.query({
domain: 'github.com'
});
req.headers({
Accept: 'application/json',
'X-API-Key': 'YOUR_API_KEY'
});
req.end(function (res) {
if (res.error) throw new Error(res.error);
console.log(res.body);
});GET /v1/expiry in Node.js (Axios)
const axios = require('axios').default;
const options = {
method: 'GET',
url: 'https://whois-domain-lookup.p.apihiver.com/v1/expiry',
params: {domain: 'github.com'},
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}GET /v1/expiry in Node.js (Fetch)
const fetch = require('node-fetch');
const url = 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com';
const options = {
method: 'GET',
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}GET /v1/expiry in JavaScript (XMLHttpRequest)
const data = null;
const xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener('readystatechange', function () {
if (this.readyState === this.DONE) {
console.log(this.responseText);
}
});
xhr.open('GET', 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com');
xhr.setRequestHeader('Accept', 'application/json');
xhr.setRequestHeader('X-API-Key', 'YOUR_API_KEY');
xhr.send(data);GET /v1/expiry in JavaScript (Axios)
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://whois-domain-lookup.p.apihiver.com/v1/expiry',
params: {domain: 'github.com'},
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}GET /v1/expiry in JavaScript (Fetch)
const url = 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com';
const options = {
method: 'GET',
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}GET /v1/expiry in JavaScript (jQuery)
const settings = {
async: true,
crossDomain: true,
url: 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com',
method: 'GET',
headers: {
Accept: 'application/json',
'X-API-Key': 'YOUR_API_KEY'
}
};
$.ajax(settings).done(function (response) {
console.log(response);
});GET /v1/expiry in Python (http.client)
import http.client
conn = http.client.HTTPSConnection("whois-domain-lookup.p.apihiver.com")
headers = {
'Accept': "application/json",
'X-API-Key': "YOUR_API_KEY"
}
conn.request("GET", "/v1/expiry?domain=github.com", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))GET /v1/expiry in Python (Requests)
import requests
url = "https://whois-domain-lookup.p.apihiver.com/v1/expiry"
querystring = {"domain":"github.com"}
headers = {
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())GET /v1/expiry in PHP (cURL)
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Accept: application/json",
"X-API-Key: YOUR_API_KEY"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}GET /v1/expiry in PHP (Guzzle)
<?php
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com', [
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => 'YOUR_API_KEY',
],
]);
echo $response->getBody();GET /v1/expiry in PHP (PECL HTTP v1)
<?php
$request = new HttpRequest();
$request->setUrl('https://whois-domain-lookup.p.apihiver.com/v1/expiry');
$request->setMethod(HTTP_METH_GET);
$request->setQueryData([
'domain' => 'github.com'
]);
$request->setHeaders([
'Accept' => 'application/json',
'X-API-Key' => 'YOUR_API_KEY'
]);
try {
$response = $request->send();
echo $response->getBody();
} catch (HttpException $ex) {
echo $ex;
}GET /v1/expiry in PHP (PECL HTTP v2)
<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://whois-domain-lookup.p.apihiver.com/v1/expiry');
$request->setRequestMethod('GET');
$request->setQuery(new http\QueryString([
'domain' => 'github.com'
]));
$request->setHeaders([
'Accept' => 'application/json',
'X-API-Key' => 'YOUR_API_KEY'
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();GET /v1/expiry in Java (AsyncHttp)
AsyncHttpClient client = new DefaultAsyncHttpClient();
client.prepare("GET", "https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com")
.setHeader("Accept", "application/json")
.setHeader("X-API-Key", "YOUR_API_KEY")
.execute()
.toCompletableFuture()
.thenAccept(System.out::println)
.join();
client.close();GET /v1/expiry in Java (java.net.http)
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com"))
.header("Accept", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());GET /v1/expiry in Java (OkHttp)
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com")
.get()
.addHeader("Accept", "application/json")
.addHeader("X-API-Key", "YOUR_API_KEY")
.build();
Response response = client.newCall(request).execute();GET /v1/expiry in Java (Unirest)
HttpResponse<String> response = Unirest.get("https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com")
.header("Accept", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.asString();GET /v1/expiry in C# (HttpClient)
using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Get,
RequestUri = new Uri("https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com"),
Headers =
{
{ "Accept", "application/json" },
{ "X-API-Key", "YOUR_API_KEY" },
},
};
using (var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}GET /v1/expiry in C# (RestSharp)
var client = new RestClient("https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com");
var request = new RestRequest("", Method.Get);
request.AddHeader("Accept", "application/json");
request.AddHeader("X-API-Key", "YOUR_API_KEY");
var response = client.Execute(request);GET /v1/expiry in Go (NewRequest)
package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Accept", "application/json")
req.Header.Add("X-API-Key", "YOUR_API_KEY")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}GET /v1/expiry in Ruby (net::http)
require 'uri'
require 'net/http'
url = URI("https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Accept"] = 'application/json'
request["X-API-Key"] = 'YOUR_API_KEY'
response = http.request(request)
puts response.read_bodyGET /v1/expiry in Swift (NSURLSession)
import Foundation
let headers = [
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY"
]
let request = NSMutableURLRequest(url: NSURL(string: "https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com")! as URL,
cachePolicy: .useProtocolCachePolicy,
timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error as Any)
} else {
let httpResponse = response as? HTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()GET /v1/expiry in Objective-C (NSURLSession)
#import <Foundation/Foundation.h>
NSDictionary *headers = @{ @"Accept": @"application/json",
@"X-API-Key": @"YOUR_API_KEY" };
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com"]
cachePolicy:NSURLRequestUseProtocolCachePolicy
timeoutInterval:10.0];
[request setHTTPMethod:@"GET"];
[request setAllHTTPHeaderFields:headers];
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
if (error) {
NSLog(@"%@", error);
} else {
NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
NSLog(@"%@", httpResponse);
}
}];
[dataTask resume];GET /v1/expiry in Kotlin (OkHttp)
val client = OkHttpClient()
val request = Request.Builder()
.url("https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com")
.get()
.addHeader("Accept", "application/json")
.addHeader("X-API-Key", "YOUR_API_KEY")
.build()
val response = client.newCall(request).execute()GET /v1/expiry in C (libcurl)
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept: application/json");
headers = curl_slist_append(headers, "X-API-Key: YOUR_API_KEY");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);GET /v1/expiry in Clojure (clj-http)
(require '[clj-http.client :as client])
(client/get "https://whois-domain-lookup.p.apihiver.com/v1/expiry" {:headers {:X-API-Key "YOUR_API_KEY"}
:query-params {:domain "github.com"}
:accept :json})GET /v1/expiry in OCaml (CoHTTP)
open Cohttp_lwt_unix
open Cohttp
open Lwt
let uri = Uri.of_string "https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com" in
let headers = Header.add_list (Header.init ()) [
("Accept", "application/json");
("X-API-Key", "YOUR_API_KEY");
] in
Client.call ~headers `GET uri
>>= fun (res, body_stream) ->
(* Do stuff with the result *)GET /v1/expiry in R (httr)
library(httr)
url <- "https://whois-domain-lookup.p.apihiver.com/v1/expiry"
queryString <- list(domain = "github.com")
response <- VERB("GET", url, query = queryString, add_headers('X-API-Key' = 'YOUR_API_KEY'), content_type(""), accept("application/json"))
content(response, "text")GET /v1/expiry in PowerShell (Invoke-WebRequest)
$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("X-API-Key", "YOUR_API_KEY")
$response = Invoke-WebRequest -Uri 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com' -Method GET -Headers $headersGET /v1/expiry in PowerShell (Invoke-RestMethod)
$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("X-API-Key", "YOUR_API_KEY")
$response = Invoke-RestMethod -Uri 'https://whois-domain-lookup.p.apihiver.com/v1/expiry?domain=github.com' -Method GET -Headers $headersGET /v1/expiry in HTTP (HTTP/1.1)
GET /v1/expiry?domain=github.com HTTP/1.1
Accept: application/json
X-Api-Key: YOUR_API_KEY
Host: whois-domain-lookup.p.apihiver.com
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.