Whois API Reference

The Whois API gives you access to the domain WHOIS records stored in the WHOIS registries, with an unique, consistent interface.

You don’t have to worry about each different WHOIS response format, formatting your query for each specific TLD server or dealing with charset encoding and UTF-8 conversion.

WHOIS Lookup

Gets the raw WHOIS record for a domain as returned from the WHOIS server(s).

GET /whois/:domain

Example

Get the plain text whois record for example.com:

$ curl -u "<API_KEY>:X" https://api.robowhois.com/v1/whois/example.com

Response

The `Content-Type` of this API call is always `text/plain`, regardless the `Accept` header. The corresponding API-standard call is `GET /whois/:domain/record` that follows the global API conventions.
Status: 200
Content-Type: text/plain; charset=utf-8
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.

   Server Name: EXAMPLE.COM.RAFAELYALUFF.COM
   IP Address: 173.203.204.123
   Registrar: DOMAIN.COM, LLC
   Whois Server: whois.domain.com
   Referral URL: http://www.domain.com

   Server Name: EXAMPLE.COM.AU
   Registrar: ENETICA PTY LTD
   Whois Server: whois.enetica.com.au
   Referral URL: http://www.enetica.com.au

   Domain Name: EXAMPLE.COM
   Registrar: RESERVED-INTERNET ASSIGNED NUMBERS AUTHORITY
   Whois Server: whois.iana.org
   Referral URL: http://res-dom.iana.org
   Name Server: A.IANA-SERVERS.NET
   Name Server: B.IANA-SERVERS.NET
   Status: clientDeleteProhibited
   Status: clientTransferProhibited
   Status: clientUpdateProhibited
   Updated Date: 14-aug-2011
   Creation Date: 14-aug-1995
   Expiration Date: 13-aug-2012

>>> Last update of whois database: Tue, 23 Aug 2011 11:26:58 UTC <<<

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.
% IANA WHOIS server
% for more information on IANA, visit http://www.iana.org
% This query returned 1 object

domain:       EXAMPLE.COM

organisation: Internet Assigned Numbers Authority

created:      1992-01-01
source:       IANA

WHOIS Record

Gets the raw WHOIS record for a domain as returned from the WHOIS server(s).

GET /whois/:domain/record

Example

Get the whois record for example.com.

$ curl -u "<API_KEY>:X" https://api.robowhois.com/v1/whois/example.com/record

Response

Status: 200
Content-Type: application/json; charset=utf-8
{
  "response": {
    "daystamp": "2011-08-23",
    "record": "\nWhois Server Version 2.0\n\nDomain names in the .com and .net domains can now be registered\nwith many different competing registrars. Go to http://www.internic.net\nfor detailed information.\n\n   Server Name: EXAMPLE.COM.RAFAELYALUFF.COM\n   IP Address: 173.203.204.123\n   Registrar: DOMAIN.COM, LLC\n   Whois Server: whois.domain.com\n   Referral URL: http://www.domain.com\n\n   Server Name: EXAMPLE.COM.AU\n   Registrar: ENETICA PTY LTD\n   Whois Server: whois.enetica.com.au\n   Referral URL: http://www.enetica.com.au\n\n   Domain Name: EXAMPLE.COM\n   Registrar: RESERVED-INTERNET ASSIGNED NUMBERS AUTHORITY\n   Whois Server: whois.iana.org\n   Referral URL: http://res-dom.iana.org\n   Name Server: A.IANA-SERVERS.NET\n   Name Server: B.IANA-SERVERS.NET\n   Status: clientDeleteProhibited\n   Status: clientTransferProhibited\n   Status: clientUpdateProhibited\n   Updated Date: 14-aug-2011\n   Creation Date: 14-aug-1995\n   Expiration Date: 13-aug-2012\n\n>>> Last update of whois database: Tue, 23 Aug 2011 11:26:58 UTC <<<\n\nNOTICE: The expiration date displayed in this record is the date the \nregistrar's sponsorship of the domain name registration in the registry is \ncurrently set to expire. This date does not necessarily reflect the expiration \ndate of the domain name registrant's agreement with the sponsoring \nregistrar.  Users may consult the sponsoring registrar's Whois database to \nview the registrar's reported date of expiration for this registration.\n\nTERMS OF USE: You are not authorized to access or query our Whois \ndatabase through the use of electronic processes that are high-volume and \nautomated except as reasonably necessary to register domain names or \nmodify existing registrations; the Data in VeriSign Global Registry \nServices' (\"VeriSign\") Whois database is provided by VeriSign for \ninformation purposes only, and to assist persons in obtaining information \nabout or related to a domain name registration record. VeriSign does not \nguarantee its accuracy. By submitting a Whois query, you agree to abide \nby the following terms of use: You agree that you may use this Data only \nfor lawful purposes and that under no circumstances will you use this Data \nto: (1) allow, enable, or otherwise support the transmission of mass \nunsolicited, commercial advertising or solicitations via e-mail, telephone, \nor facsimile; or (2) enable high volume, automated, electronic processes \nthat apply to VeriSign (or its computer systems). The compilation, \nrepackaging, dissemination or other use of this Data is expressly \nprohibited without the prior written consent of VeriSign. You agree not to \nuse electronic processes that are automated and high-volume to access or \nquery the Whois database except as reasonably necessary to register \ndomain names or modify existing registrations. VeriSign reserves the right \nto restrict your access to the Whois database in its sole discretion to ensure \noperational stability.  VeriSign may restrict or terminate your access to the \nWhois database for failure to abide by these terms of use. VeriSign \nreserves the right to modify these terms at any time. \n\nThe Registry database contains ONLY .COM, .NET, .EDU domains and\nRegistrars.\n% IANA WHOIS server\n% for more information on IANA, visit http://www.iana.org\n% This query returned 1 object\n\ndomain:       EXAMPLE.COM\n\norganisation: Internet Assigned Numbers Authority\n\ncreated:      1992-01-01\nsource:       IANA\n\n"
  }
}

WHOIS Parts

Gets the WHOIS record for a domain without merging the one or more responses returned by the contacted WHOIS server(s).

GET /whois/:domain/parts

Learn more about the difference between thin and thick WHOIS lookups.

Example

Get the whois parts that composes the record for example.com:

$ curl -u "<API_KEY>:X" https://api.robowhois.com/v1/whois/example.com/parts

Response

Status: 200
Content-Type: application/json; charset=utf-8
{
  "response": {
    "daystamp": "2011-08-23",
    "parts": [
      {
        "body": "\nWhois Server Version 2.0\n\nDomain names in the .com and .net domains can now be registered\nwith many different competing registrars. \n\n   Server Name: EXAMPLE.COM.RAFAELYALUFF.COM\n   IP Address: 173.203.204.123\n   Registrar: DOMAIN.COM, LLC\n   Whois Server: whois.domain.com\n   Referral URL: http://www.domain.com\n\n   Server Name: EXAMPLE.COM.AU\n   Registrar: ENETICA PTY LTD\n   Whois Server: whois.enetica.com.au\n   Referral URL: http://www.enetica.com.au\n\n   Domain Name: EXAMPLE.COM\n   Registrar: RESERVED-INTERNET ASSIGNED NUMBERS AUTHORITY\n   Whois Server: whois.iana.org\n   Referral URL: http://res-dom.iana.org\n   Name Server: A.IANA-SERVERS.NET\n   Name Server: B.IANA-SERVERS.NET\n   Status: clientDeleteProhibited\n   Status: clientTransferProhibited\n   Status: clientUpdateProhibited\n   Updated Date: 14-aug-2011\n   Creation Date: 14-aug-1995\n   Expiration Date: 13-aug-2012\n",
        "host": "whois.crsnic.net"
      },
      {
        "body": "% IANA WHOIS server\n% for more information on IANA, visit http://www.iana.org\n% This query returned 1 object\n\ndomain:       EXAMPLE.COM\n\norganisation: Internet Assigned Numbers Authority\n\ncreated:      1992-01-01\nsource:       IANA\n\n",
        "host": "whois.iana.org"
      }
    ]
  }
}

WHOIS Properties

Gets the parsed WHOIS record for a domain.

GET /whois/:domain/properties

Example

Get the parsed WHOIS record for:

$ curl -u "<API_KEY>:X" https://api.robowhois.com/v1/whois/example.com/properties

Response

Status: 200
Content-Type: application/json; charset=utf-8
{
  "response": {
    "daystamp": "2011-08-23",
    "properties": {
      "disclaimer": "Please note that the following result could be a subgroup of the data contained in the database. Additional information can be visualized at: http://www.nic.it/cgi-bin/Whois/whois.cgi",
      "domain": "google.it",
      "domain_id": null,
      "referral_whois": null,
      "referral_url": null,
      "status": "registered",
      "available?": false,
      "registered?": true,
      "created_on": "1999-12-10T00:00:00-05:00",
      "updated_on": "2010-12-13T01:11:33-05:00",
      "expires_on": "2011-11-27T00:00:00-05:00",
      "registrar": {
        "id": "REGISTER-REG",
        "name": "REGISTER-REG",
        "organization": "Register.it s.p.a.",
        "url": null
      },
      "registrant_contacts": [
        {
          "id": "GOOG175",
          "type": 1,
          "name": "Google Ireland Holdings",
          "organization": "Google Ireland Holdings",
          "address": "70 Sir John Rogersons Quay",
          "city": "Dublin",
          "zip": "2",
          "state": "IE",
          "country": null,
          "country_code": "IE",
          "phone": null,
          "fax": null,
          "email": null,
          "created_on": "2008-11-27T16:47:22-05:00",
          "updated_on": "2011-01-12T07:57:37-05:00"
        }
      ],
      "admin_contacts": [
        {
          "id": "TT4277",
          "type": 2,
          "name": "Tsao Tu",
          "organization": "Tu Tsao",
          "address": "70 Sir John Rogersons Quay",
          "city": "Dublin",
          "zip": "2",
          "state": "IE",
          "country": null,
          "country_code": "IE",
          "phone": null,
          "fax": null,
          "email": null,
          "created_on": "2008-11-27T16:47:22-05:00",
          "updated_on": "2011-01-12T07:58:12-05:00"
        }
      ],
      "technical_contacts": [
        {
          "id": "2409-REGT",
          "type": 3,
          "name": "Technical Support",
          "organization": "Register.it S.p.A.",
          "address": "Via Montessori s/n",
          "city": "Bergamo",
          "zip": "24126",
          "state": "BG",
          "country": null,
          "country_code": "IT",
          "phone": null,
          "fax": null,
          "email": null,
          "created_on": "2009-09-28T11:01:09-04:00",
          "updated_on": "2009-09-28T11:01:09-04:00"
        }
      ],
      "nameservers": [
        {
          "name": "ns1.google.com",
          "ipv4": null,
          "ipv6": null
        },
        {
          "name": "ns4.google.com",
          "ipv4": null,
          "ipv6": null
        },
        {
          "name": "ns2.google.com",
          "ipv4": null,
          "ipv6": null
        },
        {
          "name": "ns3.google.com",
          "ipv4": null,
          "ipv6": null
        }
      ]
    }
  }
}

Domain Availability

#### Deprecated Method This method has been replaced by the [Availability API](/api/v1/availability/#domain-availability).

Gets the information about domain availability.

GET /whois/:domain/availability