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

_Copied

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

_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

Shell Node.js Java Python PHP Ruby JS C# Go C Swift


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.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

_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.