Expiring and Deleted Domain's Whois Documentation
Overview
-
Expiring and Deleted Domain's WHOIS API
Our Expiring and Deleted Domains API is a valuable tool that enables you to easily access and download lists of expiring or recently deleted domain names. This convenient feature allows you to effortlessly obtain the database files for expiring and dropped domains through either our billing dashboard or API.
Authorization
You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.
Expiring and Deleted Domain's WHOIS API
API
https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped

https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=expired

Input parameters: required
apiKey Get your API key from our billing dashboard.
fileType Required whois fileType for Domainer subscription like expired|dropped.
Input parameters: optional
date Date parameter is optional. The most recent file will be downloaded if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd).
Code Snippets
curl --location --request GET 'https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped'
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped',
'headers': {
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped")
.method("GET", null)
.build();
Response response = client.newCall(request).execute();
import http.client
conn = http.client.HTTPSConnection("files.whoisfreaks.com")
payload = ''
headers = {}
conn.request("GET", "/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
'https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
require "uri"
require "net/http"
url = URI("https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
response = https.request(request)
puts response.read_body
var requestOptions = {
method: 'GET',
redirect: 'follow'
};
fetch("https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
var client = new RestClient("https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped"
method := "GET"
client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(curl, CURLOPT_URL, "https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped");
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
struct curl_slist *headers = NULL;
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
res = curl_easy_perform(curl);
}
curl_easy_cleanup(curl);
import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif
var semaphore = DispatchSemaphore (value: 0)
var request = URLRequest(url: URL(string: "https://files.whoisfreaks.com/v3.0/download?apiKey=API_KEY&date=2023-08-24&fileType=dropped")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data else {
print(String(describing: error))
semaphore.signal()
return
}
print(String(data: data, encoding: .utf8)!)
semaphore.signal()
}
task.resume()
semaphore.wait()
Response
Download sample of expired whois files from here expired_sample.csv.gzDownload sample of dropped whois files from here dropped_sample.csv.gz
CSV file Format
num,domain_name,query_time,create_date,update_date,expiry_date,domain_registrar_id,domain_registrar_name,domain_registrar_whois,domain_registrar_url,registrant_name,registrant_company,registrant_address,registrant_city,registrant_state,registrant_zip,registrant_country_code,registrant_country,registrant_email,registrant_phone,registrant_fax,administrative_name,administrative_company,administrative_address,administrative_city,administrative_state,administrative_zip,administrative_country_code,administrative_country,administrative_email,administrative_phone,administrative_fax,technical_name,technical_company,technical_address,technical_city,technical_state,technical_zip,technical_country_code,technical_country,technical_email,technical_phone,technical_fax,billing_name,billing_company,billing_address,billing_city,billing_state,billing_zip,billing_country_code,billing_country,billing_email,billing_phone,billing_fax,name_server_1,name_server_2,name_server_3,name_server_4,domain_status_1,domain_status_2,domain_status_3,domain_status_4,reseller_name,reseller_email,reseller_phone
1,"sato800.com","2023-03-17 13:43:53","2020-02-01","2023-03-16","2023-02-01","49","GMO Internet Group, Inc. d/b/a Onamae.com","whois.discount-domain.com","http://gmo.jp","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","domainexp01.onamae.jp","domainexp02.onamae.jp","","","redemptionPeriod","","","","","",""
2,"petsafety.pet","2023-03-17 13:43:53","2016-03-08","2023-03-16","2023-03-08","146","GoDaddy.com, LLC","whois.godaddy.com/","http://www.godaddy.com/domains/search.aspx?ci=8990","REDACTED FOR PRIVACY","Domains By Proxy, LLC","","REDACTED FOR PRIVACY","Arizona","REDACTED FOR PRIVACY","US","United States","Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","REDACTED FOR PRIVACY","Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","REDACTED FOR PRIVACY","Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","","","","","","","","","","","","","","","redemptionPeriod","inactive","","","","",""
3,"8xaxz.xyz","2023-03-17 13:43:53","2021-02-02","2023-03-16","2023-02-02","146","Go Daddy, LLC","whois.godaddy.com","https://www.godaddy.com/","","Domains By Proxy, LLC","","","Arizona","","US","United States","Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.","","","","","","","","","","","Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.","","","","","","","","","","","Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.","","","","","","","","","","","Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.","","","","","","","redemptionPeriod","inactive","serverTransferProhibited","serverHold","","",""
4,"zoltantothdesign.com","2023-03-17 13:43:53","2022-02-02","2023-03-16","2023-02-02","49","GMO Internet Group, Inc. d/b/a Onamae.com","whois.discount-domain.com","http://gmo.jp","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","ns2.gm111.parklogic.com","ns1.gm111.parklogic.com","","","redemptionPeriod","","","","","",""
HTTP Error Codes
Below mentioned possible type of error and desc.
Whois Files Status API
API
https://files.whoisfreaks.com/v3.0/status

Response
{
"expired": {
"lastUpdate": "2023-08-24",
"availableFrom": "2023-07-01"
},
"gtld": {
"lastUpdate": "2023-08-24",
"availableFrom": "2023-07-01"
},
"dropped": {
"lastUpdate": "2023-08-24",
"availableFrom": "2023-07-01"
},
"database_updates": [
{
"dailyBaseAvailable_From": "2023-07-01",
"dailyBaseLastUpdate": "2023-08-24"
},
{
"weeklyBaseAvailable_From": "2023-06-05",
"weeklyBaseLastUpdate": "2023-08-21"
},
{
"monthlyBaseAvailable_From": "2023-03-01",
"monthlyBaseLastUpdate": "2023-08-01"
}
],
"cctld": {
"lastUpdate": "2023-08-26",
"availableFrom": "2023-08-09"
}
}
FAQs
What type of information Expired domains whois files provide?
Expiring Domains are domains that have reached the end of their registration period and are currently in a state of pending deletion or redemption.
Which TLDs Whois included in Expired/dropped domains whois files?
Visit our current supported TLD's list page.
At what time do you generate your expired/dropped whois files?
The expired and deleted domain data files of a particular day are made available for download at 23:50 UTC and they are of that particular day.
Do you have notification service after generating whois files?
Yes, we inform you with an email when any type (newly - cctld - expired - dropped | dailydbUpdate - weeklydbupdate - monthlydbupdate) of file is generated.