dropdown

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

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

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'

Copy



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);
});
    
    

Copy



    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();


Copy


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"))


Copy


'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;



Copy


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



Copy


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));

Copy


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);

Copy


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))
}

Copy


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);

Copy


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()

Copy

Response

Download sample of expired whois files from here expired_sample.csv.gz
Download 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.

HTTP Code
Error Message
400 Please pass apiKey param value 400 Please pass fileType param value 404 fileType not found. Please visit documentation 401 Api record not found. [For Technical Support: support@whoisfreaks.com] 401 Provided API key is inactive. [For Technical Support: support@whoisfreaks.com] 401 Please Buy Domainer package. [For Technical Support: support@whoisfreaks.com] 401 Your Domainer package plan is inactive. [For Technical Support: support@whoisfreaks.com] 413 Please upgrade your plans.This Plan does not have to access to download file. [For Technical Support: support@whoisfreaks.com] 404 File is not available of this date. Please contact at support@whoisfreaks.com 401 You cannot download file, as requested file for date(2022-09-10) is older than your subscription start date(2022-09-15). [For Technical Support: support@whoisfreaks.com] 401 You have exceeded the download limit of 20000 [For Technical Support: support@whoisfreaks.com]

Whois Files Status API

API

GET https://files.whoisfreaks.com/v3.0/status Copy
Copied

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.