Note:

You can download expired whois files from our billing dashboard manually. Please Sign in and download whois files after buying domainer subscription or you can use our API for downloading the whois files.

Calling API

For getting the API key, you need to get started with our developer account. When you sign up then you can copy the API key from our billing dashboard. Here is the API endpoint:

Copied
GET https://files.whoisfreaks.com/v1.0/2021-01-12?apiKey=API_KEY&fileType=expired

Input parameters: required

apiKey Get your API key from our billing dashboard.

date Required date for expiring-domains whois file. Date format should be (yyyy-MM-dd).

fileType Required whois file like newly|cctld|expired|dropped


Sample

Download sample of expired whois files from here expired_sample.csv

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
1,"gamingshopec.com","2020-02-14 19:52:40","2020-02-13","2020-02-13","2021-02-12","76","Nominalia Internet S.L.","whois.nominalia.com","http://www.nominalia.com","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","REDACTED FOR PRIVACY","Guayas","REDACTED FOR PRIVACY","","ECUADOR","","REDACTED.FORPRIVACY","REDACTED.FORPRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","REDACTED FOR PRIVACY","Guayas","REDACTED FOR PRIVACY","","ECUADOR","","REDACTED.FORPRIVACY","REDACTED.FORPRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","REDACTED FOR PRIVACY","Barcelona","REDACTED FOR PRIVACY","","SPAIN","","REDACTED.FORPRIVACY","REDACTED.FORPRIVACY","","","","","","","","","","","","","dns4.atreshost.com","dns3.atreshost.com","","","OK","",""
2,"waytoaway.com","2020-02-14 14:20:23","2020-02-13","","2021-02-12","463","Regional Network Information Center, JSC dba RU-CENTER","whois.nic.ru","http://www.nic.ru","Privacy protection service - whoisproxy.ru","Privacy protection service - whoisproxy.ru","","Moscow","Moscow","123308","","RUSSIAN FEDERATION","waytoaway.com@whoisproxy.ru","+7.4957856536","","Privacy protection service - whoisproxy.ru","Privacy protection service - whoisproxy.ru","","Moscow","Moscow","123308","","RUSSIAN FEDERATION","waytoaway.com@whoisproxy.ru","+7.4957856536","","Privacy protection service - whoisproxy.ru","Privacy protection service - whoisproxy.ru","","Moscow","Moscow","123308","","RUSSIAN FEDERATION","waytoaway.com@whoisproxy.ru","+7.4957856536","","","","","","","","","","","","","","ns8.nic.ru","ns3.nic.ru","ns4.nic.ru","clientTransferProhibited","","",""
3,"hardcoreking.com","2020-02-15 16:13:08","2020-02-13","2020-02-13","2021-02-12","1052","EuroDNS S.A.","http://whois.rotld.ro","http://www.eurodns.com","Whois Privacy","Whois Privacy (enumDNS dba)","","Root-sur-Syre","","6921","","LUXEMBOURG","ce7615fee0996491_o@whoisprivacy.com","+352.27720304","","Whois Privacy","Whois Privacy (enumDNS dba)","","Root-sur-Syre","","6921","","LUXEMBOURG","ce7615fee0996491_a@whoisprivacy.com","+352.27720304","","Whois Privacy","Whois Privacy (enumDNS dba)","","Root-sur-Syre","","6921","","LUXEMBOURG","ce7615fee0996491_t@whoisprivacy.com","+352.27720304","","","","","","","","","","","","","dns3.p03.nsone.net","dns1.p03.nsone.net","dns2.p03.nsone.net","dns4.p03.nsone.net","clientTransferProhibited","","",""
4,"hardcorekings.com","2020-02-15 14:42:55","2020-02-13","2020-02-13","2021-02-12","1052","EuroDNS S.A.","http://whois.rotld.ro","http://www.eurodns.com","Whois Privacy","Whois Privacy (enumDNS dba)","","Root-sur-Syre","","6921","","LUXEMBOURG","cfd9c4253a2c238e_o@whoisprivacy.com","+352.27720304","","Whois Privacy","Whois Privacy (enumDNS dba)","","Root-sur-Syre","","6921","","LUXEMBOURG","cfd9c4253a2c238e_a@whoisprivacy.com","+352.27720304","","Whois Privacy","Whois Privacy (enumDNS dba)","","Root-sur-Syre","","6921","","LUXEMBOURG","cfd9c4253a2c238e_t@whoisprivacy.com","+352.27720304","","","","","","","","","","","","","dns3.p03.nsone.net","dns1.p03.nsone.net","dns2.p03.nsone.net","dns4.p03.nsone.net","clientTransferProhibited","","",""       
            

HTTP Error Codes

            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "FileType type did not found.you can pass param newly|dropped|expired",
    "path": "/v1.0/2021-01-12/fileType=&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "Api record not found. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/2021-01-12/fileType=expired&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "Please Buy Domainer package. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/2021-01-12/fileType=expired&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "Your Domainer package plan is inactive. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/2021-01-12/fileType=expired&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "Please upgrade your plans.This Plan does not have to access to download file. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/2021-01-12/fileType=expired&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "You have exceeded the download limit of 10000 [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/2021-01-12/fileType=expired&apikey=6363653972fe4df89638c45db1acf016"
}
            
            

Code Snippet

Wide-variety of industries against any domain name, such as domain registration details, domain IP address, domain owner email address and many more such as domain registration details.


    curl --location --request GET 'https://files.whoisfreaks.com/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired'



var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://files.whoisfreaks.com/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired',
  '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/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired")
  .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", "/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))




     'https://files.whoisfreaks.com/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired',
  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/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired")

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/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));




var client = new RestClient("https://files.whoisfreaks.com/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired");
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/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=expired"
  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/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&");
  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/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&")!,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()




FAQs

What type of information Expired domains whois files provide?

An Expired domain which did not renewed by current owner and its expiry date occur. Domain registrars keep the domain for 30-45 days. Expired domains whois files provide these expired domains whois.



How many TLDs Whois included in Expired domains whois files?

You can check here current supported TLD's List



Can I Download the file manually?

Yes, you can download any type of whois files after sign in from our billing.



At what time do you generate your expired whois files?

00:00 UTC time. You can compare your time zone with UTC here



Can I check programmatically any type(newly|cctld|expired|dropped) of generated file status?

Yes, with our API endpoint https://files.whoisfreaks.com/v1.0/status you can check details of whois files.



Do you have notification service after generating whois files?

Yes, we inform you with an email when any type(newly|cctld|expired|dropped) of file is generated.