Revision as of 15:56, 27 March 2018 (view source) WikiAdmin (Talk | contribs) (→‎Additional information: Individual Registrant Privacy Option (IRPO)) ← Older edit		Latest revision as of 10:08, 30 June 2023 (view source) WikiAdmin (Talk | contribs)
(4 intermediate revisions by one user not shown)
Line 9:		Line 9:
	}}		}}
−	{{#repositoryinfo: NZEPP-LIVE-1API | co.nz }}	+	{{#repositoryinfo: NZEPP2-LIVE-1API | co.nz }}
	{{Sidebar}}		{{Sidebar}}
	<div style="font-size: 250%;">'''CO.NZ'''</div><br/>		<div style="font-size: 250%;">'''CO.NZ'''</div><br/>
Line 158:		Line 158:
	= TLD specific =		= TLD specific =
−	{{#var:NOSPECIFIC}}	+
		+	== Second Level Domain Registration Documents ==
		+	* EPP Guide: [[Media:HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf|HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf]]
		+
		+	== Generating an Authorisation Code ==
		+	<pre>
		+	COMMAND = ModifyDomain
		+	GENERATERANDOMAUTH = 1
		+	DOMAIN = <domain>
		+	</pre>
		+
		+	=== Expiring Authorisation Codes ===
		+
		+	Please note that Auth Codes may only be obtained from the current registrar of a domain name, and that they expire after 30 days.
		+
		+	== Registering Reserved Second Level Domains ==
		+
		+	The .NZ Registry offers Registrants, who already own a .CO.NZ (NET.NZ / ORG.NZ ) domain the possibility to register the name-pendant under .NZ. Requirement is, that the .CO.NZ (NET.NZ / ORG.NZ )  is registered in HEXONET. If this is the case, you should submit a "transfer-request" for the corresponding .NZ domain, by providing the Auth code of the existing .CO.NZ (NET.NZ / ORG.NZ ) - Domain. If necessary, see above on how to obtain an Auth code for an existing domain.
		+
		+	The transfer may then be requested in the Control Panel or with the following API command using the new Auth code (AUTH) of the third-level domain:
		+
		+	<pre>
		+	COMMAND = Transferdomain
		+	DOMAIN = example.nz
		+	AUTH = ABCDE1234
		+	PERIOD = 1
		+	EOF
		+	</pre>
		+
		+	== Modify Contact ==
		+	Specify which dedicated contact details should be affected by the DISCLOSE parameter setting. If not stated the DISCLOSE parameter affects all possible contact details. Multiple values are possible and have to be separated by a blank space.
		+	<pre>
		+	command=modifycontact
		+	contact=<CONTACT-HANDLE>
		+	X-CZ-DISCLOSE=1
		+	X-CZ-DISCLOSE-ELEMENTS=ADDR VOICE FAX EMAIL VAT IDENT NOTIFYEMAIL
		+	</pre>
	= Addons =		= Addons =

---

Latest revision as of 10:08, 30 June 2023

.NZ is the country code domain for New Zealand. CO.NZ is a secondary domain also available for New Zealand Kiwis.

Introduced	1987
Country	New Zealand
Registry	NZRS Ltd
IDN Capable	Yes
Webpage	Register .NZ or CO.NZ

Contents 1 NOTE 2 Registry 3 Periods 4 API 4.1 Domain Registration 4.1.1 Additional information: Individual Registrant Privacy Option (IRPO) 4.2 Domain Transfer 4.3 Delete Domain 4.4 Restore Domain 4.5 Ownerchange 5 TLD specific 5.1 Second Level Domain Registration Documents 5.2 Generating an Authorisation Code 5.2.1 Expiring Authorisation Codes 5.3 Registering Reserved Second Level Domains 5.4 Modify Contact 6 Addons 7 RegistrarOC 7.1 Restore Process

[edit] NOTE

[edit] Registry

TLD	-
Allowed TLDs	-
Registry	NZRS Ltd.
Dispute Policy	Rules
Registrar	1api GmbH
WHOIS-Server	whois.srs.net.nz
WHOIS-Update	Real-Time
Min. Characters	1
Max. Characters	63
Character Set	Letters and numbers Hyphens ("-"), however not at the beginning or directly in front of the TLD IDN: allowed
Limitations	Registrant Contacts: Required: 1 / Maximum: 1 Admin Contacts: Required: 1 / Maximum: 1 Tech Contacts: Required: 1 / Maximum: 1 Billing Contacts: Required: 0 / Maximum: 1
{{{Possible Extensions}}}
IDN capable	Yes
Restore capable	Real-Time
Handle Updates	Supported
Registration System	Real-Time
Allowed number of NS	0 to 10
Registry Nameservercheck	No
Host IP-Addresses Type	IPv4 / IPv6
Hosts managed as	Object
Root Nameserver Update	hourly
SEC DNS Interface	DS data interface
Transferclass	Pull
Transfer Periods	0Y,1Y
Transfer Authcode required	Yes
Transfer Real-Time	Yes
Transfer Lock	Yes
Transfer Confirmation (Request / Approve)	- / -
Owner Change by	Update

[edit] Periods

{{{Possible Extensions}}}
Registration Periods	1-10 years
Add Grace Period	0 days
Accounting Period	-1 day
Finalization Period	44 days
Failure Period	44 days
Payment Period	-61 days
Deletion Restorable Period	90 days
Deletion Hold Period	2 days
Explicit Renewals	Yes
Renewal Periods	1-9 years

[edit] API

[edit] Domain Registration

Domains can be registered in Real-Time with the API AddDomain command.

command = AddDomain
domain  = (DOMAIN)

REQUIRED

ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)

OPTIONAL

auth = <TEXT> | <NULL>
transferlock = 0 | 1 | <NULL>
subuser = <TEXT> | <NULL>
X-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option) 
X-REGISTRANT-DISCLOSE = 0 | 1  (0 = select privacy option, 1 = turn off privacy option) 
X-ADMIN-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option) 
X-TECH-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option)

[edit] Additional information: Individual Registrant Privacy Option (IRPO)

[edit] Domain Transfer

The transfer has to be initiated by the gaining registrar and can be requested with the API TransferDomain command.
A valid Authorization Code must be provided to initiate a transfer successfully. You may obtain the authorization code from the losing registrar.
Domain transfers are processed in Real-Time.

command = TransferDomain
domain = (DOMAIN)

REQUIRED

action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER
auth = <TEXT>

OPTIONAL

order = CREATE | REPLACE | UPDATE

subuser = <TEXT> | <NULL>
period = <PERIOD>
transferlock = 0 | 1 | <NULL>

[edit] Delete Domain

Domains can be deleted with the API DeleteDomain command.
There is a Deletion Restorable Period of 90 days and a following Deletion Hold Period of 2 days.

command = DeleteDomain
domain = (DOMAIN)

REQUIRED

n/a

[edit] Restore Domain

Restores can be processed in realtime. A restore is possible within 90 days upon deletion. Please use the command RestoreDomain.

command = RestoreDomain
domain = (DOMAIN)

REQUIRED

n/a

OPTIONAL

renewalmode = <NULL> | <TEXT>
subuser = <TEXT>

[edit] Ownerchange

An Ownerchange is free of charge and can be done with the API ModifyDomain command.

[edit] TLD specific

[edit] Second Level Domain Registration Documents

 * EPP Guide: HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf

[edit] Generating an Authorisation Code

COMMAND = ModifyDomain
GENERATERANDOMAUTH = 1
DOMAIN = <domain>

[edit] Expiring Authorisation Codes

Please note that Auth Codes may only be obtained from the current registrar of a domain name, and that they expire after 30 days.

[edit] Registering Reserved Second Level Domains

The .NZ Registry offers Registrants, who already own a .CO.NZ (NET.NZ / ORG.NZ ) domain the possibility to register the name-pendant under .NZ. Requirement is, that the .CO.NZ (NET.NZ / ORG.NZ ) is registered in HEXONET. If this is the case, you should submit a "transfer-request" for the corresponding .NZ domain, by providing the Auth code of the existing .CO.NZ (NET.NZ / ORG.NZ ) - Domain. If necessary, see above on how to obtain an Auth code for an existing domain.

The transfer may then be requested in the Control Panel or with the following API command using the new Auth code (AUTH) of the third-level domain:

COMMAND = Transferdomain
DOMAIN = example.nz
AUTH = ABCDE1234
PERIOD = 1
EOF

[edit] Modify Contact

Specify which dedicated contact details should be affected by the DISCLOSE parameter setting. If not stated the DISCLOSE parameter affects all possible contact details. Multiple values are possible and have to be separated by a blank space.

command=modifycontact
contact=<CONTACT-HANDLE>
X-CZ-DISCLOSE=1
X-CZ-DISCLOSE-ELEMENTS=ADDR VOICE FAX EMAIL VAT IDENT NOTIFYEMAIL

[edit] Addons

[edit] RegistrarOC

Restore Process

To restore a domain as a RegistrarOC customer, you simply have to execute the RestoreDomain command. HEXONET directly forwards the restore request to the registry, which performs the restore in real-time. As soon as the restore is complete, the domain will get assigned to your account with the original domain data.