Generic Top-Level Domain (gTLD) Registry Agreements

gTLD Registry Agreements establish the rights, duties, liabilities, and obligations ICANN requires of registry operators to run gTLDs.

TLD Sponsorship Agreement: Attachment 16 (.museum)

ICANN | TLD Sponsorship Agreement: Attachment 16 (.museum)

  ICANN Logo

TLD Sponsorship Agreement: Attachment 16 (.museum)

Posted: 17 October 2001


Whois Data Specification—Provider Access

Sponsor shall ensure Registry Operator provides bulk access to up-to-date data concerning domain name and nameserver registrations maintained by Registry Operator in connection with the Sponsored TLD on a daily schedule, only for purposes of providing free public query-based access to up-to-date data concerning domain name and nameserver registrations in multiple TLDs, to a party designated from time to time in writing by ICANN (the "Designated Recipient"). Any agreement between ICANN and a Designated Recipient for the license of such data (a "Whois License Agreement") will provide Sponsor with the right to enforce the Designated Recipient's obligations under this Attachment and the Whois License Agreement directly against the Designated Recipient, whether through being made a party to or third-party beneficiary of such agreement or through such other means as may be appropriate. In addition, any Whois License Agreement will include the following provisions governing the use of such data by the Designated Recipient:

1. The Designated Recipient shall only use the data provided by the Registry Operator for the purpose of providing free public query-based Whois access as described in Subsection 3.11.1 of the TLD Sponsorship Agreement (including Attachment 15, as it may be amended from time to time). The Designated Recipient may not use such data for any other purpose.

2. The Designated Recipient shall use best efforts to implement any corrections to the data provided by the Registry Operator as soon as practicable.

3. The Designated Recipient must take such technical and organizational security measures as are, at a minimum, equivalent to those implemented by the Registry Operator with respect to such data.

4. Except for providing free public query-based access according to item 1 above, the Designated Recipient shall not transfer the data to any third party for any purpose except in the event that such third party becomes bound in the same manner as a Designated Recipient by the provisions of this Attachment and the Whois License Agreement.

The procedures for providing access, and the specification of the content and format of this data, will be as stated below, until changed according to the TLD Sponsorship Agreement. This Attachment is subject to change by agreement of Sponsor and ICANN during the design process as well as during the IETF standards process. In addition, Sponsor agrees to require Registry Operator to implement changes to this Attachment specified by ICANN to conform to the IETF provreg working group's protocol specification no later than 135 days after the IETF specification is adopted as a Proposed Standard [RFC 2026, section 4.1.1]. Accordingly, the following provides the target architecture and initial functionality.

A. Procedures for Providing Access

Sponsor shall ensure Registry Operator prepares (i) full data sets for one day of each week (the day to be designated by ICANN) and (ii) incremental data sets for all seven days of each week. Full and incremental data sets shall be up-to-date and coherent as of 1200 UTC on the day to which they relate. Until a different day is designated by ICANN, the full data sets will be prepared for Sundays. (Note that on the ICANN-designated day both an incremental and a full data set are prepared.)

1. Preparation of Files Containing Data Sets. Each full and incremental data set consists of an XML document meeting the content and format requirements of Parts B and C of this document. Once the XML document is generated, the following preparation steps will be performed:

a. The XML document will be placed in a file named according to the following convention:

For full data sets: "wfYYMMDD" where "YYMMDD" is replaced with the date (YY=last two digits of year; MM=number of month; DD=day; in all cases a single-digit number should be left-padded with a zero).

For incremental data sets: "wiYYMMDD" where "YYMMDD" follows the same format.

b. The Registry Operator may optionally split the document using the Unix SPLIT command (or equivalent) to produce files no less than 1GB each (except the final file). If files are split, an MD5 file (produced with MD5SUM or equivalent) must be included with the resulting files to isolate errors in case of transfer fault. The Registry Operator may optionally compress the document using the Unix GZIP command (or equivalent) to reduce the file size.

c. The file(s) will then be encrypted and signed using PGP, version 6.5.1 or above, with a key of DH/DSS type and 2048/1024-byte length. (Note that PGP compresses the escrow file in addition to encrypting it.) The Data Recipient's public key will be used for the encryption and the Registry Operator's private key will be used for the signature. Public keys will be exchanged between the Registry Operator and the Designated Recipient by e-mail, physical delivery of floppy diskettes, or other agreed means.

2. Transmission of Full Data Sets. Once prepared, full data sets will be provided either by the procedures for incremental data sets described in item A(3) below or, at the option of either the Registry Operator or the Designated Recipient, by writing the full data set to DAT tape (or other media mutually agreed by Registry Operator and the Designated Recipient) and sending it to the Designated Recipient by expedited delivery service (such as FedEx or DHL). If sent by expedited delivery service, the full data set will be scheduled for arrival no later than the second calendar day following the day to which the full backup relates.

3. Transmission of Incremental Data Sets. To permit the transmission of incremental data sets, Sponsor shall ensure Registry Operator makes them available for download by the Designated Recipient by Internet File Transfer Protocol. Incremental data sets will be made available for download no later than 2000 UTC on the day to which they relate.

B. Content

The data sets (whether full or incremental) will consist of four types of objects:

1. Domain Objects. One type of object is the domain object, which corresponds to a single Registered Name. Each domain object includes the following data:

Domain ID
Domain Name
Sponsoring Registrar (IANA-assigned identifier)
Domain Status
Registrant, Administrative, Technical and Billing Contact Information including
   ENS Identity
   Contact ID
   Contact Name
   Contact Organization
   Contact Address, City, State/Province, Country
   Contact Postal Code
Contact Phone, Fax, E-mail
Name Servers associated with this domain
Created by Registrar (IANA-assigned identifier)
Last Updated by Registrar (IANA-assigned identifier)
Last Transferred Date
Additional fields (Registrar specified)
Additional fields (Sponsor specified)
Domain Registration Date
Domain Expiration Date
Domain Last Updated Date



















2. Nameserver Objects. A second type of object is the nameserver object, which corresponds to a single registered nameserver. The nameserver object includes the following data:

Nameserver ID
Nameserver Name
IP Addresses associated
Sponsoring Registrar (IANA-assigned identifier)
Created by Registrar (IANA-assigned identifier)
Name Server Last Updated by Registrar (IANA-assigned identifier)
Last Transferred Date





3. Contact Objects. A third type of object is the contact object, which corresponds to a single contact (whether registrant, administrative, technical or billing contact). The contact object includes the following data:

Contact ID
Contact Name
Contact Organization
ENS Identity
Contact Address, City, State/Province, Country
Contact Postal Code
Contact Phone, Fax, E-mail
Contact Registration Date
Contact Last Updated Date
Currently Associated
Contact Status
Additional fields (Sponsor specified)
Sponsoring Registrar (IANA-assigned identifier)
Created Registrar (IANA-assigned identifier)
Last Transferred Date













4. Registrar Object. The final type of object corresponds to a single registrar. It includes the following data:

Registrar ID (conforming to the IANA registrar-ids registry)
Registrar Name
Registrar Status
Registrar Address, City, State/Province, Country
Registrar Postal Code
Registrar Phone, Fax, E-mail
Registrar Administrative Contacts
Registrar Billing Contacts






5. Objects Contained in Full and Incremental Data Sets. Full data sets include one domain object for each Registered Name within the Sponsored TLD; and nameserver, contact, and registrar objects for each nameserver, contact, and registrar referred to in any domain object. Incremental data sets consist of (a) those of the objects constituting a full data set that have been added or updated since the last incremental data set and (b) notations of deletion of any objects since the last incremental data set.

C. Format

Full and incremental data sets will be XML version 1.0, UTF-8 encoded documents conforming to the following schema:

<?xml version="1.0"?>

<schema targetNamespace="urn:musedoma:whoisdb"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:whoisdb="urn:musedoma:whoisdb"
xmlns:eppcom="urn:ietf:params:xml:ns:eppcom-1.0"
xmlns:epp="urn:ietf:params:xml:ns:epp-1.0"
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
xmlns:host="urn:ietf:params:xml:ns:host-1.0"
elementFormDefault="qualified">







<!--Import EPP Element Types-->
<import namespace="urn:ietf:params:xml:ns:eppcom-1.0" schemaLocation="eppcom-1.0.xsd"/>
<import namespace="urn:ietf:params:xml:ns:epp-1.0" schemaLocation="epp-1.0.xsd"/>
<import namespace="urn:ietf:params:xml:ns:contact-1.0" schemaLocation="contact-1.0.xsd"/>
<import namespace="urn:ietf:params:xml:ns:domain-1.0" schemaLocation="domain-1.0.xsd"/>
<import namespace="urn:ietf:params:xml:ns:host-1.0" schemaLocation="host-1.0.xsd"/>




<annotation>
  <documentation>XML Schema for Whois Data Escrow From MuseDoma
  </documentation>
</annotation>


<!--Child Element-->
<element name="whois-data" type="whoisdb:whoisDbType"/>

<complexType name="whoisDbType">
  <choice>
    <element name="full" type="whoisdb:fullsetType"/>
    <element name="incremental" type="whoisdb:partialType"/>
  </choice>
  <attribute name="tld" type="whoisdb:tldType" use="required"/>
  <attribute name="date" type="dateTime" use="required"/>
</complexType>






<simpleType name="tldType">
  <restriction base="string">
    <enumeration value="museum"/>
  </restriction>
</simpleType>



<complexType name="fullsetType">
  <sequence minOccurs="1">
    <element name="contact" type="ContactType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="domain" type="DomainType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="host" type="host:infDataType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="registrar" type="whoisdb:registrarType" minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
</complexType>






<complexType name="partialType">
  <sequence minOccurs="1">
    <element name="contact" type="ContactType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="domain" type="DomainType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="host" type="host:infDataType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="registrar" type="whoisdb:registrarType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="del-contact" type="contact:sIDType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="del-domain" type="domain:sNameType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="del-host" type="host:sNameType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="del-registrar" type="eppcom:clIDType" minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
</complexType>










<complexType name="registrarIDType">
  <sequence>
    <element name="registrar-id" type="eppcom:clIDType"/>
  </sequence>
</complexType>



<complexType name="registrarType">
  <sequence>
    <element name="roid" type="eppcom:roidType"/>
    <element name="registrar-id" type="eppcom:clIDType"/>
    <element name="name" type="whoisdb:registrarNameType"/>
    <element name="address" type="contact:addrType"/>
    <element name="web-url" type="whoisdb:registrarWebUrlType"/>
    <element name="iana-id" type="whoisdb:registrarIanaIDType"/>
    <element name="contact" type="whoisdb:registrarContactType" maxOccurs="5"/>
    <element name="status" type="whoisdb:registrarStatusType"/>
    <element name="crDate" type="dateTime"/>
    <element name="upDate" type="dateTime" minOccurs="0"/>
  </sequence>
</complexType>












<simpleType name="registrarNameType">
  <restriction base="token">
    <minLength value="1"/>
    <maxLength value="128"/>
  </restriction>
</simpleType>




<simpleType name="registrarWebUrlType">
  <restriction base="token"/>
</simpleType>

<simpleType name="registrarIanaIDType">
  <restriction base="token"/>
</simpleType>

<complexType name="registrarContactType">
  <simpleContent>
    <extension base="eppcom:roidType">
      <attribute name="type" use="required">
        <simpleType>
          <restriction base="string">
            <enumeration value="administrative"/>
            <enumeration value="billing"/>
            <enumeration value="technical"/>
          </restriction>
        </simpleType>
      </attribute>
    </extension>
  </simpleContent>
</complexType>













<simpleType name="registrarStatusType">
  <restriction base="string">
    <enumeration value="active"/>
    <enumeration value="suspended"/>
    <enumeration value="defunct"/>
  </restriction>
</simpleType>





<complexType name="DomainType">
  <sequence>
    <element name="name" type="eppcom:labelType"/>
    <element name="roid" type="eppcom:roidType"/>
    <element name="status" type="domain:statusType" maxOccurs="14"/>
    <element name="registrant" type="domain:contactType" minOccurs="0"/>
    <element name="contact" type="domain:contactType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="ns" type="eppcom:labelType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="host" type="eppcom:labelType" minOccurs="0" maxOccurs="unbounded"/>
    <element name="clID" type="eppcom:clIDType"/>
    <element name="crID" type="eppcom:clIDType"/>
    <element name="crDate" type="dateTime"/>
    <element name="upID" type="eppcom:clIDType" minOccurs="0"/>
    <element name="upDate" type="dateTime" minOccurs="0"/>
    <element name="exDate" type="dateTime" minOccurs="0"/>
    <element name="trDate" type="dateTime" minOccurs="0"/>
    <element name="authInfo" type="eppcom:authInfoType" minOccurs="0"/>
    <element name="ENSIdentity" type="whoisdb:ENSIdType"/>

















  </sequence>
</complexType>

<complexType name="ContactType">
  <sequence>
    <element name="id" type="eppcom:clIDType"/>
    <element name="roid" type="eppcom:roidType"/>
    <element name="status" type="contact:statusType" maxOccurs="8"/>
    <element name="ascii" type="contact:postalType"/>
    <element name="i15d" type="contact:postalType" minOccurs="0"/>
    <element name="voice" type="contact:e164Type" minOccurs="0"/>
    <element name="fax" type="contact:e164Type" minOccurs="0"/>
    <element name="email" type="normalizedString"/>
    <element name="clID" type="eppcom:clIDType"/>
    <element name="crID" type="eppcom:clIDType"/>
    <element name="crDate" type="dateTime"/>
    <element name="upID" type="eppcom:clIDType" minOccurs="0"/>
    <element name="upDate" type="dateTime" minOccurs="0"/>
    <element name="trDate" type="dateTime" minOccurs="0"/>
    <element name="authInfo" type="eppcom:authInfoType" minOccurs="0"/>
    <element name="ENSIdentity" type="whoisdb:ENSIdType"/>
  </sequence>
</complexType>


















<simpleType name="ENSIdType">
  <restriction base="token">
    <minLength value="8"/>
    <maxLength value="14"/>
    <pattern value="MUSEUM-[a-zA-Z0-9]+"/>
  




</restriction>
</simpleType>

</schema>

Prior drafts:

16 October 2001
9 September 2001


Comments concerning the layout, construction and functionality of this site
should be sent to webmaster@icann.org.

Page Updated 04-Nov-2001

(c) 2001  The Internet Corporation for Assigned Names and Numbers. All rights reserved.