![]() |
Whois Specifications (15 August 2007) |
The Whois service consists of two parts:
The Registry Whois system has been designed for data protection compliance, robustness, availability, and performance. Provisions for detection of abusive usage, like excessive numbers of queries from one source, have been taken into account, and other countermeasures against abuse, like throttling and filtering, will be activated if necessary.
The Registry Operator will in addition to the WHOIS service make available an email address to assist members of the Internet technical community if necessary
This Appendix is subject to change by agreement of Registry Operator and ICANN during the IETF standards process. Further, Registry Operator reserves the right to develop these services internally or outsource management of the facilities to an external contractor under terms that are consistent with the standards of the proposed service. The Whois service is described in more detail below.
Registry Operator will support queries for Summary, Standard, Detailed, or Extensive Whois data.
Summary and Standard Whois data is available to the general public at no cost. This data is useful for searches to check whether a .name domain already exists or whether there is a similar .name domain in existence.
Summary Whois queries provide very limited information, such as whether a domain name exists and its registration status.
Standard Whois queries about domain-name registrations will provide more information, including: registrar ID, registrant ID, admin ID, technical ID, billing ID, Nameserver ID, Creation Date, and Expiration Date. No personally identifiable data relating to the registrant is available from this query.
Registry Operator reserves the right to revoke access for any requestor found to be using the Summary or Standard Whois data for marketing purposes, spamming, or other improper or unlawful purposes.
For the fields contained in returned Summary or Standard Whois results, and an example of a returned record, please see the output specification and examples below.
Queries for Detailed or Extensive Whois data require a password. Each query type has its own requirements for password distribution, described in detail below.
Detailed Whois Data
To receive a password for the Detailed Whois data a requestor must complete the online application available at http://whois.nic.name. The application process is open to the general public. Passwords will be issued to requestors by e-mail or fax. To acquire a password, users must agree (via a click through license) not to use the data for marketing purposes, spamming, or other improper or unlawful purposes.
Upon completing an application for Detailed Whois searches, an applicant will receive five passwords, each of which is effective for one Detailed Whois search only. A fee of US$2 may be charged for the five passwords. Registry Operator may, in its discretion, not charge the US$2 fee and require requestors instead to authenticate themselves using a credit card or other personally identifiable information. Passwords obtained through the interface at http://whois.nic.name for Detailed Whois searches are valid for 24 hours and may be used using either the web-based or port 43 Whois interface.
Registry Operator reserves the right to revoke the password of any requestor found to have provided and failed to correct materially inaccurate contact information or to be using the Detailed Whois data in a manner inconsistent with terms and conditions set forth in the Detailed query application and agreement.
Detailed Whois queries will return more extensive contact information (not including e-mail addresses or phone and fax numbers) about registrants. Administrative, technical, or billing contacts that are the same as the registrant contact will not be separately displayed. For the fields contained in a returned Detailed Whois Results page and an example of a returned record, please see the output specification and examples below.
Extensive or Detailed Whois Data
To receive a persistent password and continuous, free access to the Extensive Whois data, a requestor must enter into a written contract with Registry Operator. In initial implementation, requestors will download, execute, and mail the contract to Registry Operator, who will then e-mail or fax passwords. The contract will be substantially in the form of the Application and Agreement - .name WHOIS Extensive Search Database attached as Exhibit A to this Appendix.
Registry Operator may, in its discretion, modify the manner in which Extensive Whois passwords are obtained in either or both of the following ways:
In accepting the Extensive Agreement, a requestor is required to represent that the password will be used only for:
Further, in accepting the Extensive Agreement, or accessing the Detailed Whois, a requestor will also be required to represent that:
Registry Operator reserves the right to revoke the password of any requestor found to have provided and failed to correct materially inaccurate contact information or to be using the Extensive Whois data in a manner inconsistent with terms and conditions set forth in the Extensive Agreement. In the case of institutional or organizational Users, Registry Operator will attempt to resolve abuses by Authorized Individual Users without terminating the User's access for legitimate purposes. Further, Registry Operator may modify the Extensive Agreement to accommodate the procurement and contracting constraints under which governmental requestors may be required by law or regulation to operate.
Passwords will be issued to requestors by e-mail or fax. Passwords for the Extensive Whois data may be changed by the Registry Operator on a bi-monthly basis via e-mail to the address set forth in the Extensive Agreement. Passwords for the Extensive Whois data will be renewable annually upon re-certification by password holder.
Extensive Whois queries will return more extensive contact information than Detailed Whois queries. Information about e-mail forwarding registrations may be obtained only through Extensive Whois queries. For the fields contained in a returned Extensive Whois Results page, and an example of a returned record, please see the output specification and examples below.
Registry Operator will provide Whois data through an interactive web page and a port 43 Whois service. Summary, Standard, or Detailed Whois queries may be made through either access method with the same output formats, described below. Extensive queries can only be made through the web interface.
Web-based queries can be made through a Whois interface on the http://whois.nic.name website.
Registry Operator will also provide an RFC 3912-compliant Whois service via port 43 to whois.nic.name.
The passwords and data are provided by Registry Operator "as-is." The data is provided without any representations or warranties as to its accuracy and/or completeness. Registry Operator disclaims all warranties with respect to the password and data, either express or implied, including but not limited to the implied warranties of merchantability, fitness for a particular purpose, and non-infringement of third-party rights. In jurisdictions that do not allow the exclusion of implied warranties or the exclusion or limitation of incidental or consequential damages, the above limitations or exclusions will not apply.
The response to any request may be an error message or a successful query. If an error occurs, the service uses different error messages, depending on the severity and cause of the error.
Under normal operations the Registry Operator shall make reasonable efforts to continuously update the data as requests are handled, in a matter of seconds or minutes. The Registry Operator shall ensure that records in the Whois server are updated no later than 24 hours after the registration or modification transaction with the registrar is completed.
Queries can be made for five object types (domain, contact, nameserver, registrar, and defensive registration) with four levels of detail (Summary, Standard, Detailed, or Extensive). E-mail forwarding searches can be conducted only at the Extensive level.
For web access, object types and query levels will be specified by controls on the form. For port 43 queries, the query syntax determines the object type and query level. Particular object types and query levels can be specified by including an optional keyword, an optional modifier, and/or an optional password in the query. (If no keyword, modifier or password are supplied, the default query will search only domain objects at the Summary level of detail.)
Searches for particular object types may be specified as follows:
Levels of detail may be specified by including an optional modifier and/or password to the query. The default query level is Summary. A "Standard" query level can be specified by including the "=" modifier. When a password is provided, the response will be returned in Detailed or Extensive format, depending on the manner in which the password was obtained.
Example queries appear below.
Sample Query Explanationjohn.smith.name
or
domain john.smith.nameor smith.name
or
domain smith.namesummary query for domain name domain = john.smith.name
or
domain=smith.name
standard query for domain name
domain john.smith.name XyYpF4Ju8Ma5
or
domain smith.name XyYpF4Ju8Ma5
detailed query for domain name nameserver ns.example.name summary query for nameserver
Each data object shall be represented as a set of key/value pairs, where each key runs from the start of the line, until the first colon (":"), and where any white space found immediately preceding the first colon shall not be counted as part of the key. All data excluding the first continuous sequence of white space following the first colon, up to but excluding the line feed should count as part of the value.
All Whois data will be in the ASCII character set, which has encoding compatible with UTF-8 for easy transition to including internationalized data, and as per the IETF's recommendations on i18n in Internet protocols. For fields where more than one value exists, multiple key/value pairs with the same key shall be allowed (for example to list multiple nameservers). The first key/value pair after a blank line should be considered the start of a new record, and should be considered as identifying that record, and is used to group data, such as hostnames and IP addresses, or a domain name and registrant information, together.
The following table specifies the data elements reported in response to various query types and levels:
Flags and Public/Extensive Whois fields:
Sections:
If the data is not available, the key will not be displayed. The "flags" column applies to all output formats.
Domain Name Record SectionField name Flags Summary Standard Detailed ExtensiveDomain Name ID X X X XDomain Name X X X XSponsoring Registrar ID XSponsoring Registrar X X XDomain Status M X X X XRegistrant ID X X XRegistrant Organization O X XRegistrant Name X XRegistrant Address X XRegistrant City X XRegistrant State/Province O X XRegistrant Country X XRegistrant Postal Code O X XRegistrant Phone Number XRegistrant Fax Number O XRegistrant Email XOther names registered by registrant OM XAdmin ID X U XAdmin Organization O U XAdmin Name U XAdmin Address U XAdmin City U XAdmin State/Province O U XAdmin Country U XAdmin Postal Code O U XAdmin Phone Number U XAdmin Fax Number O U XAdmin Email U XTech ID X U XTech Organization O U XTech Name U XTech Address U XTech City U XTech State/Province O U XTech Country U XTech Postal Code O U XTech Phone Number U XTech Fax Number O U XTech Email U XBilling ID X U XBilling Organization O U XBilling Name U XBilling Address U XBilling City U XBilling State/Province O U XBilling Country U XBilling Postal Code O U XBilling Phone Number U XBilling Fax Number O U XBilling Email U X MName Server O X X XName Server ID O XCreated On X X XExpires On X X XUpdated On X X X
|
SLD Email Record
|
||||||
|
Section
|
Field name
|
Flags
|
Summary
|
Standard
|
Detailed
|
Extensive
|
|
|
SLD Email ID
|
|
|
|
|
X
|
|
|
SLD Email
|
|
|
|
|
X
|
|
|
Sponsoring Registrar
|
|
|
|
|
X
|
|
|
SLD Email Status
|
M
|
|
|
|
X
|
|
|
Registrant ID
|
|
|
|
|
X
|
|
|
Registrant Organization
|
O
|
|
|
|
X
|
|
|
Registrant Name
|
|
|
|
|
X
|
|
|
Registrant Address
|
|
|
|
|
X
|
|
|
Registrant City
|
|
|
|
|
X
|
|
|
Registrant State/Province
|
O
|
|
|
|
X
|
|
|
Registrant Country
|
|
|
|
|
X
|
|
|
Registrant Postal Code
|
O
|
|
|
|
X
|
|
|
Registrant Phone Number
|
|
|
|
|
X
|
|
|
Registrant Fax Number
|
O
|
|
|
|
X
|
|
|
Registrant Email
|
|
|
|
|
X
|
|
|
Other names registered by registrant
|
OM
|
|
|
|
X
|
|
|
Admin ID
|
|
|
|
|
X
|
|
|
Admin Organization
|
O
|
|
|
|
X
|
|
|
Admin Name
|
|
|
|
|
X
|
|
|
Admin Address
|
|
|
|
|
X
|
|
|
Admin City
|
|
|
|
|
X
|
|
|
Admin State/Province
|
O
|
|
|
|
X
|
|
|
Admin Country
|
|
|
|
|
X
|
|
|
Admin Postal Code
|
O
|
|
|
|
X
|
|
|
Admin Phone Number
|
|
|
|
|
X
|
|
|
Admin Fax Number
|
O
|
|
|
|
X
|
|
|
Admin Email
|
|
|
|
|
X
|
|
|
Tech ID
|
|
|
|
|
X
|
|
|
Tech Organization
|
O
|
|
|
|
X
|
|
|
Tech Name
|
|
|
|
|
X
|
|
|
Tech Address
|
|
|
|
|
X
|
|
|
Tech City
|
|
|
|
|
X
|
|
|
Tech State/Province
|
O
|
|
|
|
X
|
|
|
Tech Country
|
|
|
|
|
X
|
|
|
Tech Postal Code
|
O
|
|
|
|
X
|
|
|
Tech Phone Number
|
|
|
|
|
X
|
|
|
Tech Fax Number
|
O
|
|
|
|
X
|
|
|
Tech Email
|
|
|
|
|
X
|
|
|
Billing ID
|
|
|
|
|
X
|
|
|
Billing Organization
|
O
|
|
|
|
X
|
|
|
Billing Name
|
|
|
|
|
X
|
|
|
Billing Address
|
|
|
|
|
X
|
|
|
Billing City
|
|
|
|
|
X
|
|
|
Billing State/Province
|
O
|
|
|
|
X
|
|
|
Billing Country
|
|
|
|
|
X
|
|
|
Billing Postal Code
|
O
|
|
|
|
X
|
|
|
Billing Phone Number
|
|
|
|
|
X
|
|
|
Billing Fax Number
|
O
|
|
|
|
X
|
|
|
Billing Email
|
|
|
|
|
X
|
|
|
Created On
|
|
|
|
|
X
|
|
|
Expires On
|
|
|
|
|
X
|
|
|
Updated On
|
|
|
|
|
X
|
|
Contact record
|
||||||
|
Section
|
Field name
|
Flags
|
Summary
|
Standard
|
Detailed
|
Extensive
|
|
|
Contact ID |
|
X
|
X
|
X
|
X
|
|
|
Contact Name
|
|
|
X
|
X
|
X
|
|
|
Contact Registrar ID
|
|
|
X
|
X
|
X
|
|
|
Contact Registrar |
|
|
|
X
|
X
|
|
|
Contact Organization
|
O
|
|
|
X
|
X
|
|
|
Contact Address
|
|
|
|
X
|
X
|
|
|
Contact City
|
|
|
|
X
|
X
|
|
|
Contact State/Province
|
O
|
|
|
X
|
X
|
|
|
Contact Country
|
|
|
|
X
|
X
|
|
|
Contact Postal Code
|
O
|
|
|
X
|
X
|
|
|
Contact Phone Number
|
|
|
|
|
X
|
|
|
Contact Fax Number
|
O
|
|
|
|
X
|
|
|
Contact Email
|
|
|
|
|
X
|
|
|
Contact Status
|
M
|
|
X
|
X
|
X
|
|
|
Created On
|
|
|
X
|
X
|
X
|
|
|
Updated On
|
|
|
X
|
X
|
X
|
Name Server Record Section Field name Flags Summary Standard Detailed Extensive
M Name Server ID X X X X Name Server Name X X X Name Server Registrar ID X X X Name Server Registrar X X X Name Server Status M X X X IP Address Associated OM X X X Created On X X X Updated On X X X
Registrar Record Section Field name Flags Summary Standard Detailed Extensive Registrar ID X X X X Registrar Name X X X Registrar URL X X X Registrar Status M X X X Registrar Address X X X Registrar City X X X Registrar State/Province O X X X Registrar Country X X X Registrar Postal Code O X X X Registrar Phone Number X X X Registrar Fax Number O X X X Registrar E-mail X X X M Admin ID X X X Admin Organization O X X X Admin Name X X X Admin Address X X X Admin City X X X Admin State/Province O X X X Admin Country X X X Admin Postal Code O X X X Admin Phone Number X X X Admin Fax Number O X X X Admin Email X X X M Tech ID X X X Tech Organization O X X X Tech Name X X X Tech Address X X X Tech City X X X Tech State/Province O X X X Tech Country X X X Tech Postal Code O X X X Tech Phone Number X X X Tech Fax Number O X X X Tech Email X X X M Billing ID X X X Billing Organization O X X X Billing Name X X X Billing Address X X X Billing City X X X Billing State/Province O X X X Billing Country X X X Billing Postal Code O X X X Billing Phone Number X X X Billing Fax Number O X X X Billing Email X X X Created On X X X Updated On X X X
|
Defensive Registration Record
|
||||||
|
Section
|
Field name
|
Flags
|
Summary
|
Standard
|
Detailed
|
Extensive
|
|
M
|
Defensive Registration ID |
|
X
|
X
|
X
|
X
|
| Defensive Registration |
|
X
|
X
|
X
|
X
|
|
| Type |
|
X
|
X
|
X
|
X
|
|
| Tm-identifier |
O
|
|
X
|
X
|
X
|
|
| Country of tm-registration |
O
|
|
X
|
X
|
X
|
|
| Date of tm-registration |
O
|
|
X
|
X
|
X
|
|
| Sponsoring Registrar ID |
|
|
X
|
X
|
X
|
|
| Sponsoring Registrar |
|
|
X
|
X
|
X
|
|
| Defensive Registration Status |
M
|
|
X
|
X
|
X
|
|
| Registrant ID |
|
|
X
|
X
|
X
|
|
| Registrant Organization |
O
|
|
|
X
|
X
|
|
| Registrant Name |
|
|
|
X
|
X
|
|
| Registrant Address |
|
|
|
X
|
X
|
|
| Registrant City |
|
|
|
X
|
X
|
|
| Registrant State/Province |
O
|
|
|
X
|
X
|
|
| Registrant Country |
|
|
|
X
|
X
|
|
| Registrant Postal Code |
O
|
|
|
X
|
X
|
|
| Registrant Phone Number |
|
|
|
X
|
||
| Registrant Fax Number |
O
|
|
|
X
|
||
| Registrant Email |
|
|
|
X
|
||
| Admin ID |
|
|
X
|
X
|
X
|
|
| Admin Organization |
O
|
|
|
X
|
X
|
|
| Admin Name |
|
|
|
X
|
X
|
|
| Admin Address |
|
|
|
X
|
X
|
|
| Admin City |
|
|
|
X
|
X
|
|
| Admin State/Province |
O
|
|
|
X
|
X
|
|
| Admin Country |
|
|
|
X
|
X
|
|
| Admin Postal Code |
O
|
|
|
X
|
X
|
|
| Admin Phone Number |
|
|
|
X
|
X
|
|
| Admin Fax Number |
O
|
|
|
X
|
X
|
|
| Admin Email |
|
|
|
X
|
X
|
|
| Created On |
|
|
X
|
X
|
X
|
|
| Expires On |
|
|
X
|
X
|
X
|
|
| Updated On |
|
|
X
|
X
|
X
|
|
Input:
domain john.smith.name
-or-
john.smith.name
-or-
domain smith.name
-or-
smith.name
Output:
Note: the domain name output will always reflect the exact name entered as a query whether being a second or third level domain name.
Domain Name ID: 12345DOMAIN-NAME
Domain Name: JOHN.SMITH.name
Domain Status: ok
Input:
blocked JOHN.SMITH.name
Output:
Defensive Registration ID: 123DEFREG-NAME
Defensive Registration: SMITH
Type: Premium Defensive
Defensive Registration ID: 124DEFREG-NAME
Defensive Registration: JOHN
Type: Premium Defensive
Defensive Registration ID: 125DEFREG-NAME
Defensive Registration: JOHN.SMITH
Type: Standard Defensive
Input:
domain = john.smith.name
-or-
domain=smith.name
Output:
Note: the domain name output will always reflect the exact name entered as
a query whether being a second or third level domain name.
Domain Name ID: 12345DOMAIN-NAME
Domain Name: JOHN.SMITH.name
Sponsoring Registrar ID: 12REGISTRAR-NAME
Sponsoring Registrar Name: REGISTRAR1 INC
Domain Status: ok
Registrant ID: 123CONTACT-NAME
Admin ID: 124CONTACT-NAME
Tech ID: 124CONTACT-NAME
Billing ID: 124CONTACT-NAME
Name Server ID: 12HOST-NAME
Name Server: NS1.SMITH.name
Name Server ID: 34HOST-NAME
Name Server: NS2.SMITH.name
Created On: 2001-05-15T00:00:00Z
Expires On: 2003-05-15T00:00:00Z
Updated On: 2001-05-15T00:00:00Z
Input:
blocked = TRADEMARK
Output:
Defensive Registration ID: 125DEFREG-NAME
Defensive Registration: TRADEMARK
Type: Premium Defensive
Tm-identifier: CBE1234566
Country Of Tm-registration: Germany
Date Of Tm-registration: 1993-05-11
Sponsoring Registrar ID: 12REGISTRAR-NAME
Sponsoring Registrar: REGISTRAR1 INC
Defensive Registration Status: ok
Registrant ID: 125CONTACT-NAME
Admin ID: 125CONTACT-NAME
Created On: 2001-05-15T00:00:00Z
Expires On: 2011-05-15T00:00:00Z
Updated On: 2001-05-15T00:00:00Z
Input:
blocked = SAMPLE.MARK
Output:
Defensive Registration ID: 126DEFREG-NAME
Defensive Registration: SAMPLE.MARK
Type: Standard Defensive
Tm-identifier: CBE1234566
Country Of Tm-registration: Germany
Date Of Tm-registration: 1993-05-11
Sponsoring Registrar ID: 12REGISTRAR-NAME
Sponsoring Registrar: REGISTRAR1 INC
Registrant ID: 125CONTACT-NAME
Admin ID: 125CONTACT-NAME
Created On: 2001-05-15T00:00:00Z
Expires On: 2011-05-15T00:00:00Z
Updated On: 2001-05-15T00:00:00Z
Input:
contact = 124CONTACT-NAME
Output:
Contact ID: 124CONTACT-NAME
Contact Registrar ID: 17REGISTRAR-NAME
Contact Registrar: REGISTRAR2 INC
Contact Status: ok
Created On: 2001-05-15T00:00:00Z
Updated On: 2001-05-15T00:00:00Z
Input:
nameserver = ns.smith.name
-or-
nameserver = 24.6.0.1
Output:
Name Server ID: 123HOST-NAME
Name Server Name: NS.SMITH.NAME
Name Server Registrar ID: 12REGISTRAR-NAME
Name Server Registrar: REGISTRAR1 INC
Name Server Status: ok
IP Address Associated: 24.6.0.1
Created On: 2001-05-15T00:00:00Z
Updated On: 2001-05-15T00:00:00Z
Input:
registrar = REGISTRAR1 INC
-or-
registrar = 123REGISTRAR-NAME
Output:
Registrar ID: 17REGISTRAR-NAME
Registrar Name: REGISTRAR1 INC
Registrar URL: WWW.A-FICTIONAL-REGISTRAR-SITE.COM
Registrar Status: ok
Registrar Address: 170 OXFORD STREET
Registrar City: LONDON
Registrar Country: United Kingdom
Registrar Postal Code: W2LH 5QS
Registrar Phone Number: +44.207123456
Registrar Fax Number: +44.207123457
Registrar E-mail: DOMAINADMIN@REGISTRAR1.CO.UK
Admin ID: 124CONTACT-NAME
Admin Organization: REGISTRAR1 INC
Admin Name: JACK SMITH
Admin Address: 170 OXFORD ST