pricing background

Expiring & Dropped Domains Documentation

Expiring With Whois

ASK AI
Download a daily CSV feed of expiring domains with WHOIS data by specifying the date parameter. These domains are expected to drop soon and become available for registration.

Tip: Not sure which date to use? The Database Files Status endpoint returns the last_update and available_from dates for expiring, cleaned expired, and dropped domain feeds, so you can verify freshness before triggering a download.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
num
Record sequence number in the response
number
1
domain_name
Domain name being queried
string
mall78.com
query_time
Timestamp when WHOIS query was executed
string (YYYY-MM-DD HH:mm:ss)
2023-09-03 09:49:56
create_date
Domain creation date
string (YYYY-MM-DD)
2021-07-22
update_date
Last updated date of domain record
string (YYYY-MM-DD)
2023-09-02
expiry_date
Domain expiration date
string (YYYY-MM-DD)
2023-07-22
domain_registrar
Registrar information of the domain
domain_registrar_id
Registrar identifier
string
146
domain_registrar_name
Registrar organization name
string
godaddy.com, llc
domain_registrar_whois
Registrar WHOIS server
string
whois.godaddy.com
domain_registrar_url
Registrar website URL
string
http://www.godaddy.com
registrant_contact
Registrant (domain owner) contact information
registrant_name
Name of registrant
string
Redacted for Privacy
registrant_company
Company of registrant
string
Private by Design, LLC
registrant_address
Registrant street address
string
REDACTED FOR PRIVACY
registrant_city
Registrant city
string
CA
registrant_state
Registrant state
string
Capital Region
registrant_zip
Registrant ZIP/Postal code
string
101
registrant_country_code
Country code
string
US
registrant_country
Country name
string
United States
registrant_email
Registrant email (may be privacy protected)
string
registrant_phone
Registrant phone number
string
+354.4212434
registrant_fax
Registrant fax number
string
administrative_contact
Administrative contact details for the domain
administrative_name
Admin contact name
string
Redacted for Privacy
administrative_company
Admin company
string
Privacy service provided by Withheld for Privacy ehf
administrative_address
Admin address
string
Kalkofnsvegur 2
administrative_city
Admin city
string
Reykjavik
administrative_state
Admin state
string
Capital Region
administrative_zip
Admin ZIP
string
101
administrative_country_code
Admin country code
string
IS
administrative_country
Admin country
string
Iceland
administrative_email
Admin email
string
administrative_phone
Admin phone
string
+354.4212434
administrative_fax
Admin fax
string
N/A
technical_contact
Technical contact details for domain infrastructure
technical_name
Technical contact name
string
Redacted for Privacy
technical_company
Technical company
string
Privacy service provided by Withheld for Privacy ehf
technical_address
Technical address
string
Kalkofnsvegur 2
technical_city
Technical city
string
Reykjavik
technical_state
Technical state
string
Capital Region
technical_zip
Technical ZIP
string
101
technical_country_code
Technical country code
string
IS
technical_country
Technical country
string
Iceland
technical_email
Technical email
string
technical_phone
Technical phone
string
+354.4212434
technical_fax
Technical fax
string
N/A
billing_contact
Billing contact details for domain payments
billing_name
Billing contact name
string
N/A
billing_company
Billing company
string
N/A
billing_address
Billing address
string
N/A
billing_city
Billing city
string
N/A
billing_state
Billing state
string
N/A
billing_zip
Billing ZIP
string
N/A
billing_country_code
Billing country code
string
N/A
billing_country
Billing country
string
N/A
billing_email
Billing email
string
N/A
billing_phone
Billing phone
string
N/A
billing_fax
Billing fax
string
N/A
dns
Name server and DNS configuration
name_servers
List of authoritative name servers
array
ns1.example.com, ns2.example.com
domain_status
Domain lifecycle and registry status flags
array
redemptionPeriod, pendingDelete, clientTransferProhibited
reseller_contact
Reseller information (if domain is resold)
reseller_name
Reseller name
string
NAMECHEAP INC
reseller_email
Reseller email
string
reseller_phone
Reseller phone
string
+1.9854014545

Expiring Without Whois

Download a daily CSV feed of expiring domains without WHOIS data by specifying the date parameter using an API.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    Whois is a required and a boolean value parameter. Set `whois = false` to retrieve a CSV of expired domains without WHOIS information. Default value is `true`.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Expiring With Cleaned Whois

Use the API to download expiring domains with cleaned WHOIS data, excluding masked details such as privacy protections or 'Redacted for Privacy' entries.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
with_cleaned_whois_response
This list includes fields similar to those returned in a Expired With Whois
array

Dropped With Whois

Use the API to fetch the daily dropped domains file with WHOIS data in CSV format. Specify the date parameter to download the file for a particular day.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    Whois is a required and a boolean value parameter. A CSV file will be retrieved containing complete WHOIS information of all dropped domains.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
dropped_with_whois_response
This list includes fields similar to those returned in a Expired With Whois
array

Dropped Without Whois (CSV)

Access the daily CSV feed of dropped domains without WHOIS details by specifying the date parameter. This lightweight dataset focuses only on domain names that have already been released and are now open for registration.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    Whois is a required and a boolean value parameter. A CSV file will be retrieved containing complete WHOIS information of all dropped domains.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Dropped Without Whois (JSON)

Access the daily CSV feed of dropped domains without WHOIS details by specifying the date parameter. This lightweight dataset focuses only on domain names that have already been released and are now open for registration.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

  • tlds
    TLDs parameter is optional. All domains will be fetched if you don't specify any tld.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...