Domain Whois API

 

Parameters of the Domain Whois API

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

Example of the Domain Whois API

JSON

Request

Show/Hidden apache code

View source
 
 
  GET /encrypted-area HTTP/1.1
  Host: api.domainapi.com/v1/whois/takendomain.com
  Authorization: Basic YWtpcmF0ZXN0OmR0d3N0ZXN0
 

Response

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":"whois",
  "domain":"takendomain.com",
  "timestamp":1234567890,
  "content":
     {
        "whois":"<![CDATA[
Whois Server Version 2.0
 
Domain names in the .com and .net domains can now be registered
with many different competing registrars. Go to http:\/\/www.internic.net
for detailed information.
 
   Domain Name: EURODNS.COM
   Registrar: EURODNS S.A
   Whois Server: whois.eurodns.com
   Referral URL: http:\/\/www.eurodns.com
   Name Server: NS1.EURODNS.COM
   Name Server: NS2.EURODNS.COM
   Name Server: NS3.EURODNS.COM
   Status: clientTransferProhibited
   Updated Date: 10-dec-2008
   Creation Date: 08-apr-1998
   Expiration Date: 07-apr-2015
 
>>> Last update of whois database: Mon, 19 Jan 2009 09:51:07 EST <<<
 
NOTICE: The expiration date displayed in this record is the date the
registrar's sponsorship of the domain name registration in the registry is
currently set to expire. This date does not necessarily reflect the expiration
date of the domain name registrant's agreement with the sponsoring
registrar.  Users may consult the sponsoring registrar's Whois database to
view the registrar's reported date of expiration for this registration.
 
TERMS OF USE: You are not authorized to access or query our Whois
database through the use of electronic processes that are high-volume and
automated except as reasonably necessary to register domain names or
modify existing registrations; the Data in VeriSign Global Registry
Services' (\"VeriSign\") Whois database is provided by VeriSign for
information purposes only, and to assist persons in obtaining information
about or related to a domain name registration record. VeriSign does not
guarantee its accuracy. By submitting a Whois query, you agree to abide
by the following terms of use: You agree that you may use this Data only
for lawful purposes and that under no circumstances will you use this Data
to: (1) allow, enable, or otherwise support the transmission of mass
unsolicited, commercial advertising or solicitations via e-mail, telephone,
or facsimile; or (2) enable high volume, automated, electronic processes
that apply to VeriSign (or its computer systems). The compilation,
repackaging, dissemination or other use of this Data is expressly
prohibited without the prior written consent of VeriSign. You agree not to
use electronic processes that are automated and high-volume to access or
query the Whois database except as reasonably necessary to register
domain names or modify existing registrations. VeriSign reserves the right
to restrict your access to the Whois database in its sole discretion to ensure
operational stability.  VeriSign may restrict or terminate your access to the
Whois database for failure to abide by these terms of use. VeriSign
reserves the right to modify these terms at any time.
 
The Registry database contains ONLY .COM, .NET, .EDU domains and
]]>"
     }
  }
 

XML

Request

Show/Hidden apache code

View source
 
 
  GET /encrypted-area HTTP/1.1
  Host: api.domainapi.com/v1/whois/xml/takendomain.com
  Authorization: Basic YWtpcmF0ZXN0OmR0d3N0ZXN0
 

Response

Show/Hidden xml code

View source
 
 
  <response>
     <service>whois</service>
     <domain>example.com</domain>
     <timestamp>1234567890</timestamp>
     <result>
        <content>
        <![CDATA[Whois Server Version 2.0
 
  Domain names in the .com and .net domains can now be registered
  with many different competing registrars. Go to http://www.internic.net
  for detailed information.
 
  EXAMPLE.COM.RA-CHINA4LESS.COM
  EXAMPLE.COM
 
  To single out one record, look it up with "xxx", where xxx is one of the
  of the records displayed above. If the records are the same, look them up
  with "=xxx" to receive a full display for each record.
 
  &gt;&gt;&gt; Last update of whois database: Tue, 03 Mar 2009 13:47:11 UTC &lt;&lt;&lt;
 
  NOTICE: The expiration date displayed in this record is the date the
  registrar's sponsorship of the domain name registration in the registry is
  currently set to expire. This date does not necessarily reflect the expiration
  date of the domain name registrant's agreement with the sponsoring
  registrar.  Users may consult the sponsoring registrar's Whois database to
  view the registrar's reported date of expiration for this registration.
 
  TERMS OF USE: You are not authorized to access or query our Whois
  database through the use of electronic processes that are high-volume and
  automated except as reasonably necessary to register domain names or
  modify existing registrations; the Data in VeriSign Global Registry
  Services' ("VeriSign") Whois database is provided by VeriSign for
  information purposes only, and to assist persons in obtaining information
  about or related to a domain name registration record. VeriSign does not
  guarantee its accuracy. By submitting a Whois query, you agree to abide
  by the following terms of use: You agree that you may use this Data only
  for lawful purposes and that under no circumstances will you use this Data
  to: (1) allow, enable, or otherwise support the transmission of mass
  unsolicited, commercial advertising or solicitations via e-mail, telephone,
  or facsimile; or (2) enable high volume, automated, electronic processes
  that apply to VeriSign (or its computer systems). The compilation,
  repackaging, dissemination or other use of this Data is expressly
  prohibited without the prior written consent of VeriSign. You agree not to
  use electronic processes that are automated and high-volume to access or
  query the Whois database except as reasonably necessary to register
  domain names or modify existing registrations. VeriSign reserves the right
  to restrict your access to the Whois database in its sole discretion to ensure
  operational stability.  VeriSign may restrict or terminate your access to the
  Whois database for failure to abide by these terms of use. VeriSign
  reserves the right to modify these terms at any time.
 
  The Registry database contains ONLY .COM, .NET, .EDU domains and
  Registrars.]]>
        </whois>
     </content>
  </response>
 
 

Additional information