Second Level Registrations ========================== The production SRS has supported second level registrations (for example internetnzexample.nz) since 1:00pm on Tuesday 30th September 2014. For general information on second-level registrations please see: `nz Operations and Procedures Policy `_ .. contents:: Table of Contents :depth: 2 Second Level Status Codes ------------------------- The following table gives a brief summary of the second-level status and associated meaning: ========================== ================================= Second Level Domain Status Registration options ========================== ================================= Available The domain is available for registration on a first come first served basis. Prohibited For reasons of confusion, this domain name cannot be registered directly at the second level. These names include 'gov', 'government', 'com', 'edu', 'nic' and all macron variations of the current 15 second levels. Conflicted A domain status which means there are at least two registrations at the third level that have rights over this domain and so its registration at the second level may need to go through a `conflicted process `_ before it can be registered. Resolved A domain status indicating the domain name was conflicted but which agreement has been reached as to which registrant of the registrations at the third level is entitled to register it. ========================== ================================= .. note:: In addition to the second level status listed above there were two additional status PRR - Preferential Registration or Reservation. This status was only available until 1pm 30 March 2015. Reserved - these domain names were released back to the available pool of domain names at 1:00pm on Thursday 30th March 2017. WHOIS Server Changes --------------------------- The Whois server has been updated to return additional second-level specific status codes. Whois Status Codes ~~~~~~~~~~~~~~~~~~~~~~~~~~ ========== ==================== ================================= Code Value Description ========== ==================== ================================= 200 Active Registered domain 210 Pending Release A registered domain that has been cancelled and is in the 90 day Pending Release period 230 Prohibited For reasons of confusion, this domain name cannot be registered directly at the second level. These names include 'gov', 'government', 'com', 'edu', 'nic' and all macron variations of the current 15 second levels 250 Conflicted A domain status which means there are at least two registrations at the third level that have rights over this domain and so its registration at the second level may need to go through a conflicted process after the second level registration policy 'go-live' date. See DNCL Registering, Managing and Cancelling Domain Names Policy section 8 and 10 for more details on the criteria for Conflicted domains. 280 Resolved A domain status indicating the domain name was conflicted but which agreement has been reached as to which registrant of the registrations at the third level is entitled to register it. ========== ==================== ================================= Client Error Codes ~~~~~~~~~~~~~~~~~~~~~~~~~~ ========== ==================== Code Value ========== ==================== 500 Invalid characters in query string 510 Domain is not managed by this register 520 This domain is not available for registration. This error code will be returned for whois queries for Second Level Domains, for example: co.nz, org.nz, net.nz ========== ==================== All errors in this category are permanent. The request should not be retried as is, instead the request should be reviewed to ensure that it is well formed, and appropriate for the whois server. Fields ~~~~~~ In addition there is a set of source domain name fields that may be returned for any unregistered domain name at the second level under .nz if certain requirements in the pending DNCL Registering, Managing and Cancelling Domain Names Policy section 8 - Preferential Registration Eligibility are met. These source domain names will show any domain names registered at the third level that are linked to the unregistered second level domain. There will not be any gaps in the sequence. ================================ ================================= source_domain_name_01 The source domain name shows the registered third level domain name that is linked to the unregistered second level domain name source_domain_name_99 As above ================================ ================================= SRS Whois XML Transaction Changes --------------------------------- The statuses shown above for the Whois Server will be returned for the SRS Whois XML transaction. Also as per the whois server there is a set of linked domain name fields that may be returned for any unregistered domain name at the second level under .nz if certain requirements in the pending DNCL Registering, Managing and Cancelling Domain Names Policy section 8 - Preferential Registration Eligibility are met. These linked domain names will show any domain names registered at the third level that are linked to the unregistered second level domain. There will not be any gaps in the sequence. Eg: .. code-block:: xml Second Level Registrations of Resolved Domains ---------------------------------------------------------- Under the SRS or EPP protocols registrars that wish to register a domain at the second level that has Domain status = Resolved will need to perform a domain transfer. The transfer would be a normal domain transfer using a SRS DomainUpdate or an EPP DomainTransfer transaction. The UDAI that is provided for the transfer must be the UDAI of the linked third level domain (3LD). The SRS will create the domain, copying contact records from the 3LD. If the registration is successful the domain status for the second level registration will be changed to "Active". Several fields on the DomainUpdate transaction will be ignored, and other rules will apply (as logically, it is a DomainCreate). These include: * Contact details will be ignored, as they will be copied from the linked 3LD. * Name server details are NOT copied * Only one domain can be 'updated' in this way at a time, i.e. DomainNameFilter cannot be provided (this is an "implicit" restriction on transfers anyway) * Flags (e.g. Cancel, Renew, NewUDAI etc.) will be ignored * Term can be provided, but will default to 1 if not provided. * RegistrantRef may also be provided * AuditText will be auto-generated to allow for easy identification of this transaction. This will overwrite any AuditText supplied. * Domains that have sunrise statuses of Conflicted or Prohibited will be rejected. * Domains where the linked 3LD is locked cannot be registered in this way. * These types of registrations will be rejected before the go-live date .. note:: Registrars that wish to register an "available" domain at the second level must use the normal domain create transaction under the SRS or EPP protocols. EPP Transactions ---------------- EPP Query Domain Status ~~~~~~~~~~~~~~~~~~~~~~~ The EPP domain:check transaction is used to return a status showing if the domain is available or not. Informational messages will be returned only for the new second level registration statuses. The table below details the possible response values for the 'avail' attribute of the domain\:name element and the optional domain\:reason values if returned. ================ ================ ================================= avail="1/0" domain:reason Registered domain ================ ================ ================================= 0 Not returned The domain is not available for registration 1 Not returned Domain is available for registration 0 Prohibited Applies to registrations at the second level only and will be returned after the second level registration policy 'go-live' date. For reasons of confusion, this domain name cannot be registered directly at the second level. These names include 'gov', 'government', 'com', 'edu', 'nic' and all macron variations of the current 15 second levels 0 Conflicted Applies to registrations at the second level only and will be returned after the second level registration policy 'go-live' date. A domain status which means there are at least two registrations at the third level that have rights over this domain and so its registration at the second level may need to go through a conflicted process after the second level registration policy 'go-live' date. See DNCL Registering, Managing and Cancelling Domain Names Policy section 8 and 10 for more details on the criteria for Conflicted domains. 0 Resolved Applies to registrations at the second level only and returned after the second level registration policy 'go-live' date. A domain status indicating the domain name was conflicted but which agreement has been reached as to which registrant of the registrations at the third level is entitled to register it. ================ ================ ================================= EPP Request a new UDAI ~~~~~~~~~~~~~~~~~~~~~~ The EPP domain::update request with only an empty auth_info will generate a new UDAI. This will work if the domain status is Active or PendingRelease. If the status is PendingRelease it will not uncancel the domain. EPP UDAI Validate ~~~~~~~~~~~~~~~~~ The EPP domain::info request can be used to validate the UDAI by populating the domain:authInfo field. The EPP proxy will either return the domain:info details if the UDAI is valid or result code 2202 invalid authorisation details if the UDAI is invalid. Example Whois Output ~~~~~~~~~~~~~~~~~~~~ Prohibited ^^^^^^^^^^ :: whois com.nz :: version: 5.00 query_datetime: 2015-06-12T15:53:00+12:00 domain_name: com.nz query_status: 230 Prohibited Available ^^^^^^^^^ :: whois internetnznew.nz :: version: 5.00 query_datetime: 2015-06-12T15:54:49+12:00 domain_name: internetnznew.nz query_status: 220 Available Conflicted ^^^^^^^^^^ :: whois dncl.nz :: version: 5.00 query_datetime: 2015-06-12T16:13:31+12:00 domain_name: dncl.nz query_status: 250 Conflicted source_domain_name_01: dncl.co.nz source_domain_name_02: dncl.net.nz source_domain_name_03: dncl.org.nz Resolved ^^^^^^^^ :: whois bees.nz :: version: 5.00 query_datetime: 2015-06-15T11:47:54+12:00 domain_name: bees.nz query_status: 280 Resolved source_domain_name_01: bees.co.nz Domain not available ^^^^^^^^^^^^^^^^^^^^ :: whois co.nz :: version: 5.00 query_datetime: 2015-06-12T16:04:00+12:00 domain_name: co.nz query_status: 520 This domain is not available for registration Example SRS Whois XML request ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. code-block:: xml Example SRS Whois XML responses ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Prohibited ^^^^^^^^^^ .. code-block:: xml Available ^^^^^^^^^^ .. code-block:: xml Conflicted ^^^^^^^^^^ .. code-block:: xml Resolved ^^^^^^^^^^ .. note:: There is only a single linked name for Resolved .. code-block:: xml Domain not available ^^^^^^^^^^^^^^^^^^^^ For example querying a second level domain eg co.nz, net.nz etc .. code-block:: xml Domain not managed ^^^^^^^^^^^^^^^^^^^^ Querying a non-dotnz domain eg .com, .net, etc .. code-block:: xml Example EPP domain:check request ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. code-block:: xml com.nz checkdomain-2014-06-18-com.nz-019 Example EPP domain:check responses ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Prohibited ^^^^^^^^^^ .. code-block:: xml Command completed successfully com.nz Prohibited checkdomain-2014-06-18-com.nz-019 8,20925487 Available ^^^^^^^^^^ .. code-block:: xml Command completed successfully internetnznew.nz checkdomain-2014-06-18-internetnznew.nz-019 5,7536248 Conflicted ^^^^^^^^^^ .. code-block:: xml Command completed successfully internetnz.nz Conflicted checkdomain-2014-06-18-internetnz.nz-019 8,20925490 Existing third level registration ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: xml Command completed successfully internetnz.net.nz checkdomain-2014-06-18-internetnz.net.nz-019 8,20925491 Domain not available ^^^^^^^^^^^^^^^^^^^^ For example querying a second level domain eg co.nz, net.nz etc .. code-block:: xml The supplied domain name is not available for registration co.nz (unknown error detail) checkdomain-2014-06-18-co.nz-019 5,7536263 Example Second Level Registrations of Resolved Domains ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SRS Transfer to register a second level domain that has PRR, Resolved status ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Request - Transfer without Term .. code-block:: xml internetnztestdomain.nz Transfer PRR domain Response - Transfer without Term, domain created for a default 1 month term .. code-block:: xml Request - Transfer with 12 month Term .. code-block:: xml internetnztestdomain.nz Transfer PRR domain Response - Transfer with 12 month Term :: Response is the same as the above response for transfer without a Term but the BilledUntil date is 12 months into the future instead of 1 month. Response - Transfer Error ,when the UDAI is invalid .. code-block:: xml Response - Transfer Error ,when the UDAI has expired .. code-block:: xml EPP transfer to register a second level domain that has a Resolved status ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Request - Transfer without period values .. code-block:: xml Response - Transfer without period values, domain created for 1 month .. code-block:: xml Command completed successfully internetnztestdomain.nz serverApproved 999 2014-07-30T12:08:28+12:00 999 2014-07-30T12:08:28+12:00 transferdomain- internetnztestdomain.nz-testrun2 5,7535891[1]+1 Request - Transfer with 12 month period value .. code-block:: xml internetnztestdomain.nz 12 shBaAsaE transferdomain- internetnztestdomain.nz-testrun2 Response - Transfer with 12 month period value, domain created for 12 months .. code-block:: xml Command completed successfully internetnztestdomain.nz serverApproved 999 2014-07-30T12:08:28+12:00 999 2014-07-30T12:08:28+12:00 transferdomain- internetnztestdomain.nz-testrun2 5,7535891[1]+1