API Documentation

Whois Lookup

Overview

The DomainTools API is organized into distinct products with queries that follow a RESTful URL structure wherever possible. Each product offers free, un-authenticated access for the sample URLs listed with each product. If you haven’t already, you may want to review the getting started document to learn about authentication and response formats.

The Whois Lookup API provides the ownership record for a domain name or IP address with basic registration details. The API is optimized to respond quickly and is designed to handle a high volume of parallel requests. This is the ideal product to use if you have a busy web site or a long list of domains that you need to process.

https://api.domaintools.com/v1/domaintools.com/whois/

The response includes the most recent Whois record we have for the domain name or IP address you provided in the URL. This ensures a consistently fast response without a dependency on external servers and usually returns a record updated within the last few days. You can use the date property in the whois response node to check the age of the record and confirm it was updated recently enough for your needs.

In rare cases, you may request a domain for which no recent Whois record is available. If that occurs, the system will respond with an error.

Sample Response:

{
    response: {
        registrant: "DomainTools, LLC",
        registration: {
            created: "1998-08-02",
            expires: "2027-08-01",
            updated: "2020-01-09",
            registrar: "eNon, LLC",
            statuses: [
            "clientTransferProhibited"
            ]
        },
        name_servers: [
        "NS1.P09.DYNECT.NET",
        "NS2.P09.DYNECT.NET",
        "NS3.P09.DYNECT.NET",
        "NS4.P09.DYNECT.NET"
        ],
        whois: {
            date: "2022-09-28",
            "record": "Domain Name: domaintools.com\nRegistry Domain ID: 1697312_DOMAIN_COM-VRSN\nRegistrar WHOIS Server: WHOIS.ENOM.COM\nRegistrar URL: WWW.ENOM.COM\nUpdated Date: 2020-01-09T23:06:29.00Z\nCreation Date: 1998-08-02T04:00:00.00Z\nRegistrar Registration Expiration Date: 2027-08-01T04:00:00.00Z\nRegistrar: ENOM, INC.\nRegistrar IANA ID: 48\nDomain Status: clientTransferProhibited https://www.icann.org/epp#clientTransferProhibited\nRegistrant Name: REDACTED FOR PRIVACY\nRegistrant Organization: REDACTED FOR PRIVACY\nRegistrant Street: REDACTED FOR PRIVACY\nRegistrant Street: \nRegistrant City: REDACTED FOR PRIVACY\nRegistrant State/Province: WA\nRegistrant Postal Code: REDACTED FOR PRIVACY\nRegistrant Country: US\nRegistrant Phone: REDACTED FOR PRIVACY\nRegistrant Phone Ext: \nRegistrant Fax: REDACTED FOR PRIVACY\nRegistrant Email: https://tieredaccess.com/contact/5653a2cd-5657-4853-9332-a4a49cdec6cc\nAdmin Name: REDACTED FOR PRIVACY\nAdmin Organization: REDACTED FOR PRIVACY\nAdmin Street: REDACTED FOR PRIVACY\nAdmin Street: \nAdmin City: REDACTED FOR PRIVACY\nAdmin State/Province: REDACTED FOR PRIVACY\nAdmin Postal Code: REDACTED FOR PRIVACY\nAdmin Country: REDACTED FOR PRIVACY\nAdmin Phone: REDACTED FOR PRIVACY\nAdmin Phone Ext: \nAdmin Fax: REDACTED FOR PRIVACY\nAdmin Email: REDACTED FOR PRIVACY\nTech Name: REDACTED FOR PRIVACY\nTech Organization: REDACTED FOR PRIVACY\nTech Street: REDACTED FOR PRIVACY\nTech Street: \nTech City: REDACTED FOR PRIVACY\nTech State/Province: REDACTED FOR PRIVACY\nTech Postal Code: REDACTED FOR PRIVACY\nTech Country: REDACTED FOR PRIVACY\nTech Phone: REDACTED FOR PRIVACY\nTech Phone Ext: \nTech Fax: REDACTED FOR PRIVACY\nTech Email: REDACTED FOR PRIVACY\nName Server: DNS1.P04.NSONE.NET.\nName Server: DNS2.P04.NSONE.NET.\nName Server: DNS3.P04.NSONE.NET.\nName Server: DNS4.P04.NSONE.NET.\nDNSSEC: unsigned\nRegistrar Abuse Contact Email: [email protected]\nRegistrar Abuse Contact Phone: +1.4259744689\nURL of the ICANN WHOIS Data Problem Reporting System: HTTP://WDPRS.INTERNIC.NET/\n" 22 
       },
       "record_source": "domaintools.com"
   }
}

Note that not all data elements in the response will be available for all domains. What is available depends on the Whois record returned for that domain.

You must provide your
API credentials
to use this API.

Sample Queries

[HTML]
[JSON]
[XML]

General Information
Products