.nz

API commandsRestrictionsIDN

Important

New WHOIS Privacy Setting for .NZ domains from March 8, 2023.

Whether contact information is displayed in the WHOIS now depends on the domain’s new PRIVACY attribute. The value is default set to PRIVATE for individuals (personal data will not be displayed) and PUBLIC for organisations.

The domain attribute can be changed using the new X-NZ-PRIVACY extension for AddDomain and ModifyDomain commands. The PUBLIC / PRIVATE value will be available via the same extension in the StatusDomain command responses.
Individual Registrant Privacy Option is no longer available. Contact commands extensions (X-DISCLOSE and X-UNDISCLOSE) will still be available for backwards compatibility, but they are no longer relevant.

API Commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

AddDomainModifyDomainRenewDomainDeleteDomainTransferDomainRestoreDomain

Domain Registration

(API Command reference » AddDomain)

Exception

command         = AddDomain
domain          = yourdomain.nz
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
auth            = (auth)

• If a 3rd level equivalent of the domain name already exists, it is mandatory to use the AUTH of that domain to register the .nz domain name.
  • The AUTH will expire after 30 days, wherefore you might have to request a new AUTH as described in the Modify Domain example below.
• If multiple 3rd level equivalents of the domain name exist, it is mandatory to solve these conflicts first before the .nz domain name can be registered.
  • Additional details about this process can be found on the Conflicted Name Process website.
• The resolved name can only be registered using details that match the registrant details used for the qualifying 3rd level domain name. Approval will not be given for registration under other details.

<

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.nz

Domain Renewal

(API Command reference » RenewDomain)

Command

command    = RenewDomain
domain     = yourdomain.nz
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.nz

Domain Transfer

(API Command reference » TransferDomain)

Exception

command = TransferDomain
domain  = yourdomain.nz
action  = request
auth    = (auth)

• A .nz domain transfer must be initiated with a so-called authorisation code (AUTH, always 16 characters), which can be obtained from the current registrar through the owner or Admin-C of the domain.
• Please note that the AUTH changes automatically upon certain domain operations (e.g. Updates, Transfer)
• The AUTH will expire after 30 days, wherefore you might have to request a new AUTH for already existing domain names. To initiate the generation of a new AUTH through the registry, please submit a ModifyDomain command like shown in the example at DomainModification in this article.
• To check the last set AUTH of an already deleted or expired domain, you can do so using the command StatusDomainHistory.

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.nz

Domain Restrictions

There are no restrictions for .nz

Supported IDN Scripts

The following IDN scripts are supported by .nz.
Provide the LANGUAGE TAG corresponding to your desired IDN within the AddDomain command as X-IDN-LANGUAGE extension.

n/a	Maori

Get more information of “IDN tables”, which represent permitted code points (letters) allowed for Internationalised Domain Name registrations in particular registries on IANA Repository of IDN Practices.