Whois History API

With domainAPI Whois History API, go back in time and review data on domain name as it was at a specific date. All you need is to submit a domain name through the API and the API will retrieve sthe full historical whois record of the domain name at that time will be retrieved. The API service retrieves data from the leading Whois Service Provider “DomainTools” and contains whois history of millions of domains spanning over the last 10 years.

Parameters of the Whois History API

For the moment, the whois history service doesn't take parameters.

Example of the Whois History API

JSON

Request
Show/Hidden apache code
View source
 
  GET /encrypted-area HTTP/1.1
  Host: api.domainapi.com/v1/historic_whois/example.com
  Authorization: Basic YWtpcmF0ZXN0OmR0d3N0ZXN0
 
Response (voluntarily incomplete due to the real response's size)
Show/Hidden apache code
View source
 
  Server: Apache-Coyote/1.1
  Content-Type: application/json
  Transfer-Encoding: chunked
  Date: Tue, 03 Feb 2009 15:09:07 GMT
 
 

Show/Hidden javascript code
View source
 
{
    "service": "historic_whois",
    "domain": "example.com",
    "timestamp": 1234567890,
    "content": {
        "whoisHistory": {
            "historyList": [
                {
                    "whois": {
                        "name_servers": "A.IANA-SERVERS.NET",
                        "record": "Registrant:\nInternet Assigned Numbers Authority\n    4676 Admiralty Way, Suite 330\n    Marina del Rey, CA 90292\n    US\n\n    Domain Name: EXAMPLE.COM\n\n    Administrative, Technical Contact:\n        Internet Assigned Numbers Authority    iana@IANA.ORG\n        4676 Admiralty Way, Suite 330\n        Marina del Rey, CA 90292\n        US\n        310-823-9358\n        Fax- 310-823-8649\n    \n    Record last updated on 07-Jan-2002\n    Record expires on 15-Aug-2010\n    Record created on 14-Aug-1995\n    Database last updated on 11-Jan-2002 15:00:24 EST\n\n    Domain servers in listed order:\n\n    A.IANA-SERVERS.NET        192.0.34.43\n    B.IANA-SERVERS.NET        193.0.0.236\n",
                        "registrant": "Internet Assigned Numbers Authority",
                        "registration": {
                            "expires": "2010-08-15",
                            "registrar": "NETWORK SOLUTIONS, INC.",
                            "created": "1995-08-14",
                            "statuses": "ACTIVE"
                        }
                    },
                    "is_private": "0",
                    "date": "2002-01-07"
                },
 
                ...
 
                {
                    "whois": {
                        "name_servers": "B.IANA-SERVERS.NET",
                        "record": "domain:       EXAMPLE.COM ...",
                        "registrant": "Internet Assigned Numbers Authority",
                        "registration": {
                            "expires": "2011-08-13",
                            "registrar": "RESERVED-INTERNET ASSIGNED NUMBERS AUTHORITY",
                            "updated": "2004-03-26",
                            "created": "1995-08-14",
                            "statuses": "clientUpdateProhibited"
                        }
                    },
                    "is_private": "0",
                    "date": "2011-03-06"
                }
            ],
            "record_count": "22"
        }
    }
}
 
 

XML

Request
Show/Hidden apache code
View source
 
  GET /encrypted-area HTTP/1.1
  Host: api.domainapi.com/v1/historic_whois/xml/example.com
  Authorization: Basic YWtpcmF0ZXN0OmR0d3N0ZXN0
 
 
Response (voluntarily incomplete due to the real response's size)
Show/Hidden xml code
View source
 
<response>
  <service>historic_whois</service>
  <domain>example.com</domain>
  <timestamp>1234567890</timestamp>
  <content>
    <whoisHistory>
      <historyList>
        <history>
          <whois>
            <name_servers>A.IANA-SERVERS.NET</name_servers>
            <record>Registrant:
                Internet Assigned Numbers Authority
                    4676 Admiralty Way, Suite 330
                    Marina del Rey, CA 90292
                    US
 
                    Domain Name: EXAMPLE.COM
 
                    Administrative, Technical Contact:
                        Internet Assigned Numbers Authority    iana@IANA.ORG
                        4676 Admiralty Way, Suite 330
                        Marina del Rey, CA 90292
                        US
                        310-823-9358
                        Fax- 310-823-8649
 
                    Record last updated on 07-Jan-2002
                    Record expires on 15-Aug-2010
                    Record created on 14-Aug-1995
                    Database last updated on 11-Jan-2002 15:00:24 EST
 
                    Domain servers in listed order:
 
                    A.IANA-SERVERS.NET        192.0.34.43
                    B.IANA-SERVERS.NET        193.0.0.236</record>
            <registrant>Internet Assigned Numbers Authority</registrant>
            <registration>
              <expires>2010-08-15</expires>
              <registrar>NETWORK SOLUTIONS, INC.</registrar>
              <created>1995-08-14</created>
              <statuses>ACTIVE</statuses>
            </registration>
          </whois>
          <is_private>0</is_private>
          <date>2002-01-07</date>
        </history>
 
             ...
 
        <history>
          <whois>
            <name_servers>B.IANA-SERVERS.NET</name_servers>
            <record>domain:       EXAMPLE.COM
 
                organisation: Internet Assigned Numbers Authority
 
                created:      1992-01-01
                source:       IANA</record>
            <registrant>Internet Assigned Numbers Authority</registrant>
            <registration>
              <expires>2011-08-13</expires>
              <registrar>RESERVED-INTERNET ASSIGNED NUMBERS AUTHORITY</registrar>
              <updated>2004-03-26</updated>
              <created>1995-08-14</created>
              <statuses>clientUpdateProhibited</statuses>
            </registration>
          </whois>
          <is_private>0</is_private>
          <date>2011-03-06</date>
        </history>
      </historyList>
      <record_count>22</record_count>
    </whoisHistory>
  </content>
</response>
 
 
 

Additional information