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

Response

Loading response...

Fields Description

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

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

Response

Loading response...

Fields Description

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

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

Response

Loading response...

Fields Description

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

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

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