SRS Transactions¶
The SRS XML transactions below can be used by registrars to query and update the SRS.
DomainCreate¶
The DomainCreate transaction allows registrars to register a new .nz domain name.
If the transaction is successful, the domain name is registered immediately. The domain is assigned an “Active” status and the Billing Process is invoked immediately.
We recommend that you first read about the field definitions which will explain about the allowable values in the data described below.
The DomainCreate element contains the following attributes and child elements:
Attribute / <Element> |
Required |
Default val |
|---|---|---|
Term |
yes |
|
ActionId |
yes |
|
Delegate |
no |
“1” |
DomainName |
yes |
|
DomainNameUnicode |
no |
|
DomainNameLanguage |
no |
|
RegistrantRef |
no |
|
HandleId |
no |
|
<RegistrantContact> |
yes |
|
<AdminContact> |
no |
|
<TechnicalContact> |
no |
|
<NameServers> |
no |
|
<DNSSEC> |
no |
|
<AuditText> |
no |
If no administrative contact details are provided the Registrant details are used as administrative contact details as well.
If no technical contact details are provided the Registrar’s technical contact details are used.
The SRS supports internationalized domain names (IDNs). Domain names containing non-ASCII characters MUST use the Punycode encoding RFC3492 for the DomainName attribute, and provide the domain name in the original scripts in the DomainNameUnicode attribute. The DomainNameLanguage attribute may be used to provide a description of the original script and language for the domain name.
The SRS supports Privacy. When registering a domain name, a registrar is able to specify the Privacy attribute for each of the Registrant Contact, Admin Contact and Technical Contact elements. If this field is not specified, it will default to ‘0’ in DomainCreate transactions. A value other than ‘0’ or ‘1’ will result in an error being returned. The response to these transactions will include the Privacy=”1” attribute and value if the privacy flag is set for the contact.
Registering a new domain name:
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<DomainCreate ActionId="Unique Value 1234" Delegate="1" DomainName="internetnztest.co.nz" Term="12">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<NameServers>
<Server FQDN="ns1.internetnztest.co.nz" IP4Addr="8.8.8.8"/>
<Server FQDN="ns2.internetnztest.co.nz" IP4Addr="8.8.4.4"/>
</NameServers>
<AuditText>create new domain</AuditText>
</DomainCreate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="5" VerMinor="7">
<Response Action="DomainCreate" FeId="8" FeSeq="20888439" OrigRegistrarId="90" RecipientRegistrarId="90" TransId="Unique Value 1234">
<FeTimeStamp Day="11" Hour="10" Minute="43" Month="3" Second="40" TimeZoneOffset="+13:00" Year="2011"/>
<Domain Delegate="1" DomainName="internetnztest.co.nz" RegistrarId="90" Status="Active" Term="1" UDAI="SvmTxPXw">
<NameServers>
<Server FQDN="ns1.internetnztest.co.nz" IP4Addr="8.8.8.8"/>
<Server FQDN="ns2.internetnztest.co.nz" IP4Addr="8.8.4.4"/>
</NameServers>
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="11" Hour="10" Minute="43" Month="3" Second="40" TimeZoneOffset="+13:00" Year="2012"/>
<RegisteredDate Day="11" Hour="10" Minute="43" Month="3" Second="40" TimeZoneOffset="+13:00" Year="2011"/>
<AuditDetails ActionId="Unique Value 1234" RegistrarId="1">
<AuditTime>
<From Day="11" Hour="10" Minute="43" Month="3" Second="40" TimeZoneOffset="+13:00" Year="2011"/>
</AuditTime>
<AuditText><![CDATA[create new domain]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Registering a new internationalized domain name:
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<DomainCreate ActionId="SomeUniqueID X1234" Delegate="1" DomainName="xn--domain-with-mcron-z5b.co.nz" DomainNameLanguage=".NZ LATIN" DomainNameUnicode="domain-with-mācron.co.nz" RegistrantRef="ref" Term="24">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<NameServers>
<Server FQDN="ns1.test.co.nz"/>
<Server FQDN="ns2.test.co.nz"/>
</NameServers>
<AuditText>create new domain</AuditText>
</DomainCreate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="5" VerMinor="7">
<Response Action="DomainCreate" FeId="8" FeSeq="20905511" OrigRegistrarId="90" RecipientRegistrarId="90" TransId="SomeUniqueID X1234">
<FeTimeStamp Day="11" Hour="14" Minute="44" Month="3" Second="43" TimeZoneOffset="+13:00" Year="2011"/>
<Domain Delegate="1" DomainName="xn--domain-with-mcron-z5b.co.nz" RegistrantRef="ref" RegistrarId="90" Status="Active" Term="1" UDAI="FbGNuYQE">
<NameServers>
<Server FQDN="ns1.test.co.nz"/>
<Server FQDN="ns2.test.co.nz"/>
</NameServers>
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="11" Hour="14" Minute="44" Month="3" Second="43" TimeZoneOffset="+13:00" Year="2013"/>
<RegisteredDate Day="11" Hour="14" Minute="44" Month="3" Second="43" TimeZoneOffset="+13:00" Year="2011"/>
<AuditDetails ActionId="SomeUniqueID X1234" RegistrarId="1">
<AuditTime>
<From Day="11" Hour="14" Minute="44" Month="3" Second="43" TimeZoneOffset="+13:00" Year="2011"/>
</AuditTime>
<AuditText><![CDATA[create new domain]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Registering a new domain name with Privacy:
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<DomainCreate ActionId="create test-admin domain with privacy" Delegate="1" DomainName="test-private.nz" Term="1">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith" Privacy="1">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AuditText>create new domain With privacy</AuditText>
</DomainCreate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="7" VerMinor="11">
<Response Action="DomainCreate" FeId="7" FeSeq="1306223233" OrigRegistrarId="1" RecipientRegistrarId="90" TransId="create test-admin domain with privacy">
<FeTimeStamp Day="29" Hour="11" Minute="21" Month="08" Second="49" TimeZoneOffset="+12:00" Year="2017"/>
<Domain Delegate="1" DomainName="test-private.nz" RegistrarId="90" Status="Active" Term="1" UDAI="sby6DJdr">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith" Privacy="1">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="John Smith" Privacy="1">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="DefaultEmail@srs.net.nz" Name="DefaultName">
<PostalAddress Address1="DefaultAddress1" City="DefaultCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="DefaultPhone"/>
</TechnicalContact>
<BilledUntil Day="29" Hour="11" Minute="21" Month="09" Second="49" TimeZoneOffset="+13:00" Year="2017"/>
<RegisteredDate Day="29" Hour="11" Minute="21" Month="08" Second="49" TimeZoneOffset="+12:00" Year="2017"/>
<AuditDetails ActionId="create test-admin domain with privacy" RegistrarId="1">
<AuditTime>
<From Day="29" Hour="11" Minute="21" Month="08" Second="49" TimeZoneOffset="+12:00" Year="2017"/>
</AuditTime>
<AuditText>
<![CDATA[create new domain With privacy]]>
</AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Registering a new domain name with DNSSEC records:
<NZSRSRequest RegistrarId="90" VerMajor="1" VerMinor="0">
<DomainCreate ActionId="AiS5chohzuix2F" Delegate="1" DomainName="new-domain-with-ds.net.nz" Term="3">
<RegistrantContact Email="testdomain@test.net.nz" Name="Name">
<PostalAddress Address1="Address1" City="testCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="testdomain Phone"/>
</RegistrantContact>
<NameServers>
<Server FQDN="ns1.new-domain-with-ds.net.nz" IP4Addr="192.0.2.1"/>
<Server FQDN="ns2.new-domain-with-ds.net.nz" IP4Addr="192.0.2.2"/>
</NameServers>
<DNSSEC>
<DS Algorithm="5" DigestType="1" KeyTag="12892">
<Digest>3FC2FB591B6089F454B90A529C760E3F92F28399</Digest>
</DS>
<DS Algorithm="5" DigestType="2" KeyTag="12892">
<Digest>85DB78AF90EB23B5B346528482ABA500A445DDB40F5BE2F04911EE7CF7CF2335</Digest>
</DS>
</DNSSEC>
</DomainCreate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="DomainCreate" FeId="8" FeSeq="55378865" OrigRegistrarId="1" RecipientRegistrarId="90" TransId="AiS5chohzuix2F">
<FeTimeStamp Day="22" Hour="13" Minute="16" Month="01" Second="30" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="new-domain-with-ds.net.nz" RegistrarId="90" Status="Active" Term="1" UDAI="NNX55cPC">
<NameServers>
<Server FQDN="ns1.new-domain-with-ds.net.nz" IP4Addr="192.0.2.1"/>
<Server FQDN="ns2.new-domain-with-ds.net.nz" IP4Addr="192.0.2.2"/>
</NameServers>
<DNSSEC>
<DS Algorithm="5" DigestType="1" KeyTag="12892">
<Digest><![CDATA[3FC2FB591B6089F454B90A529C760E3F92F28399]]></Digest>
</DS>
<DS Algorithm="5" DigestType="2" KeyTag="12892">
<Digest><![CDATA[85DB78AF90EB23B5B346528482ABA500A445DDB40F5BE2F04911EE7CF7CF2335]]></Digest>
</DS>
</DNSSEC>
<RegistrantContact Email="testdomain@test.net.nz" Name="Name">
<PostalAddress Address1="Address1" City="testCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="testdomain Phone"/>
</RegistrantContact>
<AdminContact Email="testdomain@test.net.nz" Name="Name">
<PostalAddress Address1="Address1" City="testCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="testdomain Phone"/>
</AdminContact>
<TechnicalContact Email="DefaultEmail@srs.net.nz" Name="DefaultName">
<PostalAddress Address1="DefaultAddress1" City="DefaultCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="DefaultPhone"/>
</TechnicalContact>
<BilledUntil Day="22" Hour="13" Minute="16" Month="04" Second="30" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="22" Hour="13" Minute="16" Month="01" Second="30" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="AiS5chohzuix2F" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="13" Minute="16" Month="01" Second="30" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Registering a new domain name with Handles:
<NZSRSRequest RegistrarId="60" VerMajor="5" VerMinor="0">
<DomainCreate ActionId="20150722 create domain handles.net.nz" Delegate="1" DomainName="internetnzhandles.net.nz" Term="12">
<RegistrantContact HandleId="internetnz0001"/>
<AdminContact HandleId="internetnz0001"/>
<TechnicalContact HandleId="internetnz0001"/>
<AuditText>create new domain</AuditText>
</DomainCreate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="60" VerMajor="6" VerMinor="7">
<Response Action="DomainCreate" FeId="8" FeSeq="63682383" OrigRegistrarId="1" RecipientRegistrarId="60" TransId="20150722 create domain handles.net.nz">
<FeTimeStamp Day="22" Hour="10" Minute="35" Month="07" Second="38" TimeZoneOffset="+12:00" Year="2015"/>
<Domain Delegate="1" DomainName="internetnzhandles.net.nz" RegistrarId="60" Status="Active" Term="1" UDAI="k3yqkXP2">
<RegistrantContact ActionId="srs-1_21403" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="Internet New Zealand Inc">
<PostalAddress Address1="Internet New Zealand Inc" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</RegistrantContact>
<AdminContact ActionId="srs-1_21403" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="Internet New Zealand Inc">
<PostalAddress Address1="Internet New Zealand Inc" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</AdminContact>
<TechnicalContact ActionId="srs-1_21403" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="Internet New Zealand Inc">
<PostalAddress Address1="Internet New Zealand Inc" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</TechnicalContact>
<BilledUntil Day="22" Hour="10" Minute="35" Month="07" Second="38" TimeZoneOffset="+12:00" Year="2016"/>
<RegisteredDate Day="22" Hour="10" Minute="35" Month="07" Second="38" TimeZoneOffset="+12:00" Year="2015"/>
<AuditDetails ActionId="20150722 create domain handles.net.nz" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="10" Minute="35" Month="07" Second="38" TimeZoneOffset="+12:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[create new domain]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Registering a new domain name with default Admin and Technical contact details
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<DomainCreate ActionId="create test-admin domain" Delegate="1" DomainName="test-admin.nz" Term="1">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AuditText>create new domain With default admin and technical contacts</AuditText>
</DomainCreate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="7">
<Response Action="DomainCreate" FeId="8" FeSeq="64137071" OrigRegistrarId="1" RecipientRegistrarId="90" TransId="create test-admin domain">
<FeTimeStamp Day="29" Hour="14" Minute="32" Month="07" Second="36" TimeZoneOffset="+12:00" Year="2015"/>
<Domain Delegate="1" DomainName="test-admin.nz" RegistrarId="90" Status="Active" Term="1" UDAI="EU9d3CqE">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="DefaultEmail@srs.net.nz" Name="DefaultName">
<PostalAddress Address1="DefaultAddress1" City="DefaultCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="DefaultPhone"/>
</TechnicalContact>
<BilledUntil Day="29" Hour="14" Minute="32" Month="08" Second="36" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="29" Hour="14" Minute="32" Month="07" Second="36" TimeZoneOffset="+12:00" Year="2015"/>
<AuditDetails ActionId="create test-admin domain" RegistrarId="1">
<AuditTime>
<From Day="29" Hour="14" Minute="32" Month="07" Second="36" TimeZoneOffset="+12:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[create new domain With default admin and technical contacts]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
DomainUpdate¶
The DomainUpdate transaction enables registrars to perform a number of update functions against domains they administer, including the option to cancel, uncancel, renew, delegate and generate new UDAIs.
The DomainUpdate is also used to transfer a domain name from one registrar to another.
These update functions can be performed one function at a time in separate DomainUpdate requests, or several functions can be combined into one request.
Using DomainUpdate registrars can:
Cancel or Un-cancel a domain name by setting the Cancel attribute to either “1”or “0” respectively.
Auto-Cancel a domain name. A domain name can be cancelled immediately as mentioned above using the Cancel attribute. Alternatively a domain name can be set to be cancelled on it’s ’Billed Until date’ by setting the Term value to zero. Domain names do not automatically lapse at the end of their billing period; they are automatically renewed for the billing term specified by the registrar. Registration of a domain name has to be actively cancelled by the registrar and can only be cancelled upon request or where the registrant has not complied with their agreement with the registrar and cancellation is specified as a possible result.
Generate a new UDAI by setting the NewUDAI attribute to “1” .
Renew a domain name immediately , rather than waiting for the current billing period to end, by setting the Renew attribute to “1”. The Term attribute value has to be provided if the Renew attribute is set. The Term attribute value will be added to the Billed Until date.
Auto-Renew a domain name by re-setting the Term attribute value. The domain name will be renewed on it’s ’Billed Until date’ using the value in the Term attribute. If sent in combination with the Renew=”1” option then it is a normal renewal and the Billed Until date is updated immediately.
Transfer the management of a domain name to themselves by providing the correct UDAI. Other domain details may be changed in the same transaction. A domain name can be transferred while in PendingRelease.
Delegate the domain to appear in the .nz zone (DNS) by updating the Delegate attribute to “1”. To remove the domain from the zone without canceling it set Delegate=”0”.
Update the registrant, administrative and technical contact information.
Set Privacy by specifying the Privacy attribute for each of the Registrant Contact, Admin Contact and Technical Contact elements. If this field is not specified, it will remain unchanged for DomainUpdate transactions. A value other than ‘0’ or ‘1’ will result in an error being returned. The response to these transactions will include the Privacy=”1” attribute and value if the privacy flag is set for the contact (or the contacts that have changed if updating and FullResult is not specified).
If the FullResult attribute is set to “0” only the updated fields are returned with the response. Otherwise all fields are returned. If the RegistrarId has changed, the old registrar is notified immediately of the transfer by a message sent by the SRS which is placed in the old registrar’s message queue, waiting to be received the next time it is polled. The message contains the domain name and the new registrar name.
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
Term |
no |
|
Renew |
no |
|
NewUDAI |
no |
|
Cancel |
no |
|
UDAI |
no |
Required to transfer a domain name |
ActionID |
yes |
|
Delegate |
no |
|
RegistrantRef |
no |
|
FullResult |
no |
“1” |
HandleId |
no |
length: between 3 - 16 characters |
<DomainNameFilter> |
yes |
|
<RegistrantContact> |
no |
|
<AdminContact> |
no |
|
<TechnicalContact> |
no |
|
<NameServers> |
no |
|
<DNSSEC> |
no |
|
<AuditText> |
no |
If the administrative contact details are deleted (eg <AdminContact/> attribute with no elements) the Registrant details are used as administrative contact details as well.
If the technical contact details are deleted (eg <TechnicalContact/> attribute with no elements) the Registrar’s technical contact details are used.
Note
When a domain name transfers to a new registrar, the privacy flag of any contact details that are not explicitly specified in the DomainUpdate transaction will be honoured.
Warning
The following attributes are only used by the registry:
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
Lock |
no |
Used to lock or unlock a domain |
ConvertContactsToHandles |
no |
Generate new contact handles during a transfer in and use them instead of embedded contacts |
Cancel a domain:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="UniqueID-20150122" Cancel="1">
<DomainNameFilter>sample-domain-test.org.nz</DomainNameFilter>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="DomainUpdate" FeId="8" FeSeq="55382887" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="UniqueID-20150122">
<FeTimeStamp Day="22" Hour="16" Minute="42" Month="01" Second="04" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="sample-domain-test.org.nz" RegistrantRef="ref" RegistrarId="90" Status="PendingRelease" Term="1">
<NameServers>
<Server FQDN="ns1.dns.net.nz"/>
<Server FQDN="ns2.dns.net.nz"/>
<Server FQDN="ns3.dns.net.nz"/>
<Server FQDN="ns4.dns.net.nz"/>
</NameServers>
<RegistrantContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</RegistrantContact>
<AdminContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</AdminContact>
<TechnicalContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</TechnicalContact>
<BilledUntil Day="05" Hour="13" Minute="15" Month="02" Second="25" TimeZoneOffset="+13:00" Year="2015"/>
<RegisteredDate Day="05" Hour="13" Minute="15" Month="06" Second="25" TimeZoneOffset="+12:00" Year="2013"/>
<CancelledDate Day="22" Hour="16" Minute="42" Month="01" Second="04" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="UniqueID-20150122" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="16" Minute="42" Month="01" Second="04" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Uncancel a domain:
<NZSRSRequest VerMajor="3" VerMinor="0" RegistrarId="90">
<DomainUpdate Cancel="0" ActionId="UniqueID-2015-test">
<DomainNameFilter>sample-domain-test.org.nz</DomainNameFilter>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="DomainUpdate" FeId="8" FeSeq="55382923" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="UniqueID-20150122">
<FeTimeStamp Day="22" Hour="16" Minute="44" Month="01" Second="54" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="sample-domain-test.org.nz" RegistrantRef="ref" RegistrarId="90" Status="Active" Term="1">
<NameServers>
<Server FQDN="ns1.dns.net.nz"/>
<Server FQDN="ns2.dns.net.nz"/>
<Server FQDN="ns3.dns.net.nz"/>
<Server FQDN="ns4.dns.net.nz"/>
</NameServers>
<RegistrantContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</RegistrantContact>
<AdminContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</AdminContact>
<TechnicalContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</TechnicalContact>
<BilledUntil Day="05" Hour="13" Minute="15" Month="02" Second="25" TimeZoneOffset="+13:00" Year="2015"/>
<RegisteredDate Day="05" Hour="13" Minute="15" Month="06" Second="25" TimeZoneOffset="+12:00" Year="2013"/>
<AuditDetails ActionId="UniqueID-2015-test" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="16" Minute="44" Month="01" Second="54" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Update the domain and set the delegation status on hold:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="UniqueID-20150422" Delegate="0" RegistrantRef="ref" Term="12">
<DomainNameFilter>internetnz-change-delegate-domain.co.nz</DomainNameFilter>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="6">
<Response Action="DomainUpdate" FeId="8" FeSeq="59205650" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="UniqueID-20150423">
<FeTimeStamp Day="22" Hour="11" Minute="03" Month="04" Second="24" TimeZoneOffset="+12:00" Year="2015"/>
<Domain Delegate="0" DomainName="internetnz-change-delegate-status.co.nz" RegistrantRef="ref" RegistrarId="90" Status="Active" Term="12">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="22" Hour="11" Minute="02" Month="04" Second="35" TimeZoneOffset="+12:00" Year="2016"/>
<RegisteredDate Day="22" Hour="11" Minute="02" Month="04" Second="35" TimeZoneOffset="+12:00" Year="2015"/>
<AuditDetails ActionId="UniqueID-20150423" RegistrarId="1">
<AuditTime>
<From Year="2015"/>
</AuditTime>
<AuditText><![CDATA[]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Request a new UDAI for a domain:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="UniqueID-20150122-newudai" NewUDAI="1">
<DomainNameFilter>internetnz-sample-newudai.co.nz</DomainNameFilter>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="DomainUpdate" FeId="8" FeSeq="55383040" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="UniqueID-20150122-newudai">
<FeTimeStamp Day="22" Hour="16" Minute="51" Month="01" Second="37" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="internetnz-sample-newudai.co.nz" RegistrantRef="ref" RegistrarId="90" Status="Active" Term="1" UDAI="WEtNSgZS">
<NameServers>
<Server FQDN="ns1.dns.net.nz"/>
<Server FQDN="ns2.dns.net.nz"/>
<Server FQDN="ns3.dns.net.nz"/>
<Server FQDN="ns4.dns.net.nz"/>
</NameServers>
<RegistrantContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</RegistrantContact>
<AdminContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</AdminContact>
<TechnicalContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</TechnicalContact>
<BilledUntil Day="05" Hour="13" Minute="15" Month="02" Second="25" TimeZoneOffset="+13:00" Year="2015"/>
<RegisteredDate Day="05" Hour="13" Minute="15" Month="06" Second="25" TimeZoneOffset="+12:00" Year="2013"/>
<AuditDetails ActionId="UniqueID-20150122-newudai" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="16" Minute="51" Month="01" Second="37" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Renew a domain for 3 months immediately:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="UniqueID-20150122-renew3months" Renew="1" Term="3">
<DomainNameFilter>internetnz-sample-renew3.co.nz</DomainNameFilter>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="DomainUpdate" FeId="8" FeSeq="55383611" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="UniqueID-20150122-renew3months">
<FeTimeStamp Day="22" Hour="17" Minute="13" Month="01" Second="50" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="internetnz-sample-renew3.co.nz" RegistrantRef="ref" RegistrarId="90" Status="Active" Term="1">
<NameServers>
<Server FQDN="ns1.dns.net.nz"/>
<Server FQDN="ns2.dns.net.nz"/>
<Server FQDN="ns3.dns.net.nz"/>
<Server FQDN="ns4.dns.net.nz"/>
</NameServers>
<RegistrantContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</RegistrantContact>
<AdminContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</AdminContact>
<TechnicalContact ActionId="srs-1_1690" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</TechnicalContact>
<BilledUntil Day="05" Hour="13" Minute="15" Month="05" Second="25" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="05" Hour="13" Minute="15" Month="06" Second="25" TimeZoneOffset="+12:00" Year="2013"/>
<AuditDetails ActionId="UniqueID-20150122-renew3months" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="17" Minute="13" Month="01" Second="50" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Transfer a domain to registrar 90:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="UniqueID-20150122-transferdomain" FullResult="0" UDAI="8mWfuUPH">
<DomainNameFilter>internetnz-sample-transfer.co.nz</DomainNameFilter>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="DomainUpdate" FeId="8" FeSeq="55383816" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="UniqueID-20150122-transferdomain">
<FeTimeStamp Day="22" Hour="17" Minute="21" Month="01" Second="25" TimeZoneOffset="+13:00" Year="2015"/>
<Domain DomainName="internetnz-sample-transfer.co.nz" RegistrarId="90" Term="1">
<RegistrantContact Email="registry@internetnz.net.nz" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</RegistrantContact>
<AdminContact Email="registry@internetnz.net.nz" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</AdminContact>
<TechnicalContact Email="registry@internetnz.net.nz" Name="NZ Domain Name Registry Limited">
<PostalAddress Address1=".nz Registry Services" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</TechnicalContact>
<AuditDetails ActionId="UniqueID-20150122-transferdomain" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="17" Minute="21" Month="01" Second="25" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Update most fields for a single domain:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="6545111" Delegate="1" RegistrantRef="ref" Term="12">
<DomainNameFilter>internetnz-update-everything-domain.co.nz</DomainNameFilter>
<RegistrantContact Email="test@test.co.nz" Name="John Test">
<PostalAddress Address1="Level 10" Address2="21 Somestreet" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@test.co.nz" Name="John Test">
<PostalAddress Address1="Level 10" Address2="21 Somestreet" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@test.co.nz" Name="John Test">
<PostalAddress Address1="Level 10" Address2="21 Somestreet" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<NameServers>
<Server FQDN="test.co.nz"/>
<Server FQDN="internetnz-update-everything-domain.co.nz" IP4Addr="192.168.2.1" IP6Addr="::1"/>
</NameServers>
<DNSSEC>
<DS Algorithm="5" DigestType="1" KeyTag="12892">
<Digest>3FC2FB591B6089F454B90A529C760E3F92F28399</Digest>
</DS>
<DS Algorithm="5" DigestType="2" KeyTag="12892">
<Digest>85DB78AF90EB23B5B346528482ABA500A445DDB40F5BE2F04911EE7CF7CF2335</Digest>
</DS>
</DNSSEC>
<AuditText>audit_this</AuditText>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="DomainUpdate" FeId="8" FeSeq="55383963" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="6545111">
<FeTimeStamp Day="22" Hour="17" Minute="33" Month="01" Second="58" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="internetnz-update-everything-domain.co.nz" RegistrantRef="ref" RegistrarId="90" Status="Active" Term="12">
<NameServers>
<Server FQDN="test.co.nz"/>
<Server FQDN="internetnz-update-everything-domain.co.nz" IP4Addr="192.168.2.1" IP6Addr="::1"/>
</NameServers>
<DNSSEC>
<DS Algorithm="5" DigestType="1" KeyTag="12892">
<Digest><![CDATA[3FC2FB591B6089F454B90A529C760E3F92F28399]]></Digest>
</DS>
<DS Algorithm="5" DigestType="2" KeyTag="12892">
<Digest><![CDATA[85DB78AF90EB23B5B346528482ABA500A445DDB40F5BE2F04911EE7CF7CF2335]]></Digest>
</DS>
</DNSSEC>
<RegistrantContact Email="test@test.co.nz" Name="John Test">
<PostalAddress Address1="Level 10" Address2="21 Somestreet" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@test.co.nz" Name="John Test">
<PostalAddress Address1="Level 10" Address2="21 Somestreet" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@test.co.nz" Name="John Test">
<PostalAddress Address1="Level 10" Address2="21 Somestreet" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="05" Hour="13" Minute="15" Month="05" Second="25" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="05" Hour="13" Minute="15" Month="06" Second="25" TimeZoneOffset="+12:00" Year="2013"/>
<AuditDetails ActionId="6545111" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="17" Minute="33" Month="01" Second="58" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[audit_this]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Update a domain to use handles for RegistrantContact AdminContact and TechnicalContact.
<NZSRSRequest RegistrarId="60" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="Add internetnz0001 handles to internetnzhandles.nz">
<DomainNameFilter>internetnzhandles.nz</DomainNameFilter>
<RegistrantContact HandleId="internetnz0001"/>
<AdminContact HandleId="internetnz0001"/>
<TechnicalContact HandleId="internetnz0001"/>
<AuditText>update domain to use internetnz0001 handles</AuditText>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="60" VerMajor="6" VerMinor="7">
<Response Action="DomainUpdate" FeId="8" FeSeq="63681443" OrigRegistrarId="1" RecipientRegistrarId="60" Rows="1" TransId="Add internetnz0001 handles to internetnzhandles.nz">
<FeTimeStamp Day="22" Hour="09" Minute="17" Month="07" Second="23" TimeZoneOffset="+12:00" Year="2015"/>
<Domain Delegate="1" DomainName="internetnzhandles.nz" RegistrarId="60" Status="Active" Term="1">
<RegistrantContact ActionId="srs-1_21403" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="Internet New Zealand Inc">
<PostalAddress Address1="Internet New Zealand Inc" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</RegistrantContact>
<AdminContact ActionId="srs-1_21403" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="Internet New Zealand Inc">
<PostalAddress Address1="Internet New Zealand Inc" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</AdminContact>
<TechnicalContact ActionId="srs-1_21403" Email="registry@internetnz.net.nz" HandleId="internetnz0001" Name="Internet New Zealand Inc">
<PostalAddress Address1="Internet New Zealand Inc" Address2="P O Box 24361" City="Wellington" CountryCode="NZ" PostalCode="6021" Province="Wellington"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="9316970"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="9316979"/>
</TechnicalContact>
<BilledUntil Day="21" Hour="12" Minute="29" Month="07" Second="21" TimeZoneOffset="+12:00" Year="2016"/>
<RegisteredDate Day="21" Hour="12" Minute="29" Month="07" Second="21" TimeZoneOffset="+12:00" Year="2015"/>
<AuditDetails ActionId="Add internetnz0001 handles to internetnzhandles.nz" RegistrarId="1">
<AuditTime>
<From Day="22" Hour="09" Minute="17" Month="07" Second="23" TimeZoneOffset="+12:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[update domain to use internetnz0001 handles]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Update a domain name to use default Admin and Technical contact details.
<NZSRSRequest RegistrarId="90" VerMajor="1" VerMinor="0">
<DomainUpdate ActionId="update domain remove contact" FullResult="1">
<DomainNameFilter>test-admin.nz</DomainNameFilter>
<AdminContact/>
<TechnicalContact/>
<AuditText>update domain to use default Admin and Technical Contacts</AuditText>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="7">
<Response Action="DomainUpdate" FeId="5" FeSeq="15568986" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="update domain remove contact">
<FeTimeStamp Day="30" Hour="13" Minute="46" Month="07" Second="12" TimeZoneOffset="+12:00" Year="2015"/>
<Domain Delegate="1" DomainName="test-admin.nz" RegistrarId="90" Status="Active" Term="1">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="DefaultEmail@srs.net.nz" Name="DefaultName">
<PostalAddress Address1="DefaultAddress1" City="DefaultCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="DefaultPhone"/>
</TechnicalContact>
<BilledUntil Day="30" Hour="13" Minute="27" Month="08" Second="37" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="30" Hour="13" Minute="27" Month="07" Second="37" TimeZoneOffset="+12:00" Year="2015"/>
<AuditDetails ActionId="update domain remove contact" RegistrarId="1">
<AuditTime>
<From Day="30" Hour="13" Minute="46" Month="07" Second="12" TimeZoneOffset="+12:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[update domain to use default Admin and Technical Contacts]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Adding Privacy to a Registrant contact
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="UniqueID-test-privacy">
<DomainNameFilter>privacy-testdomain.co.nz</DomainNameFilter>
<RegistrantContact Privacy="1"/>
</DomainUpdate>
</NZSRSRequest>
<?xml version="1.0" encoding="UTF-8"?>
<NZSRSResponse RegistrarId="90" VerMajor="7" VerMinor="11">
<Response Action="DomainUpdate" FeId="7" FeSeq="1306228903" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="UniqueID-test-privacy">
<FeTimeStamp Day="30" Hour="15" Minute="30" Month="08" Second="34" TimeZoneOffset="+12:00" Year="2017"/>
<Domain Delegate="1" DomainName="privacy-testdomain.co.nz" RegistrarId="90" Status="Active" Term="1">
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith" Privacy="1">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="test phone"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="30" Hour="14" Minute="24" Month="09" Second="52" TimeZoneOffset="+13:00" Year="2017"/>
<RegisteredDate Day="30" Hour="14" Minute="24" Month="08" Second="52" TimeZoneOffset="+12:00" Year="2017"/>
<AuditDetails ActionId="UniqueID-test-privacy" RegistrarId="1">
<AuditTime>
<From Day="30" Hour="15" Minute="30" Month="08" Second="34" TimeZoneOffset="+12:00" Year="2017"/>
</AuditTime>
<AuditText/>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Update a domains nameservers and glue records
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainUpdate ActionId="Change Name Servers an IP address">
<DomainNameFilter>internetnz-sample-nameserver.co.nz</DomainNameFilter>
<NameServers>
<Server FQDN="ns1.internetnz-sample-nameserver.co.nz" IP4Addr="202.121.22.22"/>
<Server FQDN="ns2.internetnz-sample-nameserver.co.nz" IP4Addr="202.212.36.25"/>
<Server FQDN="ns3.internetnz-sample-nameserver.co.nz" IP4Addr="202.131.45.23"/>
</NameServers>
<AuditText>Change Nameserver and IP</AuditText>
</DomainUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="7" VerMinor="1">
<Response Action="DomainUpdate" FeId="7" FeSeq="1303188451" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="Change Name Servers an IP address">
<FeTimeStamp Day="02" Hour="09" Minute="49" Month="02" Second="10" TimeZoneOffset="+13:00" Year="2016"/>
<Domain Delegate="1" DomainName="internetnz-sample-nameserver.co.nz" RegistrarId="90" Status="Active" Term="1">
<NameServers>
<Server FQDN="ns1.internetnz-sample-nameserver.co.nz" IP4Addr="202.121.22.22"/>
<Server FQDN="ns2.internetnz-sample-nameserver.co.nz" IP4Addr="202.212.36.25"/>
<Server FQDN="ns3.internetnz-sample-nameserver.co.nz" IP4Addr="202.131.45.23"/>
</NameServers>
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="test phone"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="02" Hour="09" Minute="46" Month="03" Second="34" TimeZoneOffset="+13:00" Year="2016"/>
<RegisteredDate Day="02" Hour="09" Minute="46" Month="02" Second="34" TimeZoneOffset="+13:00" Year="2016"/>
<AuditDetails ActionId="Change Name Servers an IP address" RegistrarId="1">
<AuditTime>
<From Day="02" Hour="09" Minute="49" Month="02" Second="10" TimeZoneOffset="+13:00" Year="2016"/>
</AuditTime>
<AuditText><![CDATA[Change Nameserver and IP]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Note
Specifying the NameServers element will effectively replace all name servers for the domain.
DomainDetailsQry¶
The DomainDetailsQry provides registrars with the functionality to perform a variety of different queries about domains within the SRS database. It allows partial field matching, date dependencies using date range fields, and control over which data fields are returned.
Registrars can only query the domain names and the history of the domain names for which they are the current registrar. When a registrar tries to retrieve historical information from period that the domain name was not registered with them or a domain name that has been released then no results are returned.
To view history for a domain (that you are the current registrar of) you can include the ShowHistory=”1” attribute in the DomainDetailsQry request. The returned response will show all the historic data for the domain in question during the most recent period the domain was under your control as the registrar of the domain.
Note
History on domains that have been released will not be returned.
Wild-card (“*” for full words or more than two letters and “?” for single letters) searching is provided by the DomainDetailsQry.
The DomainDetailsQry element contains the following attributes and child elements:
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
Status |
no |
Active and PendingRelease |
Term |
no |
|
Delegate |
no |
|
CountResults |
no |
|
MaxResults |
no |
100 |
SkipResults |
no |
0 |
RegistrantRef |
no |
|
ShowHistory |
no |
0 |
<DomainNameFilter> |
no |
|
<NameServerFilter> |
no |
|
<RegistrantContactFilter> |
no |
|
<AdminContactFilter> |
no |
|
<TechnicalContactFilter> |
no |
|
<BilledUntilDateRange> |
no |
|
<RegisteredDateRange> |
no |
|
<CancelledDateRange> |
no |
|
<LockedDateRange> |
no |
|
<FieldList> |
no |
FieldList¶
The FieldList element contains a list of parameters that define what information is to be returned for each domain name. Each field parameter can have the value of “0” or “1”. If the parameter is set to “1” the corresponding field information is returned with the response. If the parameter is set to “0” then no information is returned.
Parameter |
Description |
|---|---|
RegistrarId |
Registrar Identification number |
RegistrarName |
Name of registrar |
Status |
Status of domain name (active or pending release) |
LockedDate |
Date and time domain name was locked |
CancelledDate |
Date and time domain name was cancelled |
Delegate |
Boolean value to indicate delegation in DNS |
NameServers |
List of name servers of domain name |
RegistrantRef |
Registrant reference if provided |
RegistrantContact |
Registrant contact details |
AdminContact |
Administrative contact details |
TechnicalContact |
Technical contact details |
DNSSEC |
DNSSEC details for domain |
Term |
Billing Term |
EffectiveFrom |
Date a domain record was replaced by a new record (-> create or update transaction) |
BilledUntil |
Date and time domain name is/was billed to |
RegisteredDate |
Date and time domain name was registered |
LastActionId |
Unique ID of the last writing transaction (create or update of domain name) |
AuditText |
Optional reference provided by user in create or update transaction |
ChangedByRegistrarId |
Registrar Id of who updated the domain name |
A query, that requests the history of the Domain name and all its details:
<NZSRSRequest RegistrarId="945" VerMajor="5" VerMinor="0">
<DomainDetailsQry MaxResults="10" ShowHistory="1" SkipResults="0">
<DomainNameFilter><![CDATA[testdomainupdate-setupclass-ts142196390685.co.nz]]></DomainNameFilter>
<FieldList AdminContact="1" AuditText="1" BilledUntil="1" CancelledDate="1" ChangedByRegistrarId="1" Delegate="1" EffectiveFrom="1" LastActionId="1" LockedDate="1" NameServers="1" RegisteredDate="1" RegistrantContact="1" RegistrantRef="1" RegistrarId="1" RegistrarName="1" Status="1" TechnicalContact="1" Term="1"/>
</DomainDetailsQry>
</NZSRSRequest>
<NZSRSResponse RegistrarId="945" VerMajor="6" VerMinor="4">
<Response Action="DomainDetailsQry" FeId="8" FeSeq="55552571" OrigRegistrarId="1" RecipientRegistrarId="945" Rows="2">
<FeTimeStamp Day="27" Hour="13" Minute="29" Month="01" Second="30" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="testdomainupdate-setupclass-ts142196390685.co.nz" RegistrantRef="ref" RegistrarId="945" RegistrarName="InternetNZ Test Registrar 945" Status="Active" Term="1">
<NameServers>
<Server FQDN="ns.co.nz"/>
<Server FQDN="ns2.co.nz"/>
</NameServers>
<RegistrantContact Email="test@internetnz-sample-domain.co.nz" Name="Registrant" Privacy="1">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnz-sample-domain.co.nz" Name="Admin">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnz-sample-domain.co.nz" Name="Tech">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="23" Hour="10" Minute="58" Month="07" Second="27" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="23" Hour="10" Minute="58" Month="01" Second="27" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="testdomainupdate-test4-ts14219639357.co.nz-1421963935.7" RegistrarId="945">
<AuditTime>
<From Day="23" Hour="10" Minute="58" Month="01" Second="56" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[renew domain for 3 months]]></AuditText>
</AuditDetails>
</Domain>
<Domain Delegate="1" DomainName="testdomainupdate-setupclass-ts142196390685.co.nz" RegistrantRef="ref" RegistrarId="945" RegistrarName="InternetNZ Test Registrar 945" Status="Active" Term="1">
<NameServers>
<Server FQDN="ns.co.nz"/>
<Server FQDN="ns2.co.nz"/>
</NameServers>
<RegistrantContact Email="test@internetnz-sample-domain.co.nz" Name="Registrant">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnz-sample-domain.co.nz" Name="Admin">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnz-sample-domain.co.nz" Name="Tech">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="23" Hour="10" Minute="58" Month="04" Second="27" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="23" Hour="10" Minute="58" Month="01" Second="27" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="testdomainupdate-setupclass-ts142196390685.co.nz-1421963906.85" RegistrarId="945">
<AuditTime>
<From Day="23" Hour="10" Minute="58" Month="01" Second="27" TimeZoneOffset="+13:00" Year="2015"/>
<To Day="23" Hour="10" Minute="58" Month="01" Second="56" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[create new domain]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
A simple DomainDetailsQry that uses the CountResults to count the domains registered under RegistrarId 90 that begin with “a” using the “*” wildcard after the “a”:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<DomainDetailsQry CountResults="1">
<DomainNameFilter><![CDATA[a*.co.nz]]></DomainNameFilter>
</DomainDetailsQry>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="DomainDetailsQry" Count="7" FeId="8" FeSeq="55552286" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="0">
<FeTimeStamp Day="27" Hour="13" Minute="13" Month="01" Second="57" TimeZoneOffset="+13:00" Year="2015"/>
</Response>
</NZSRSResponse>
Whois¶
The Whois transaction is used to retrieve the public details associated with a domain name from the SRS. This information consists mainly of contact details, relevant dates, and nameserver details. If the domain name is not registered the available status is returned.
The Whois element contains the following attributes:
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
DomainName |
yes |
|
SourceIP |
no |
Used to pass on the IP address of the originating query source for abuse detection/restrictions |
FullResult |
no |
Whois Privacy¶
Information returned from a Whois SRS query transaction will not return the following address fields if the contact privacy flag is set:
Address1
Address2
City
Province
PostalCode
Phone
Fax
Note
the Privacy attribute will not be returned by the Whois SRS transaction. This is regardless of which registrar makes the request.
Whois request to check availability:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<Whois DomainName="internetnz.net.nz" FullResult="0" SourceIP="1.2.3.4"/>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="Whois" FeId="8" FeSeq="55552190" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="27" Hour="13" Minute="07" Month="01" Second="31" TimeZoneOffset="+13:00" Year="2015"/>
<Domain DomainName="internetnz.net.nz" Status="Active"/>
</Response>
</NZSRSResponse>
Whois request to query all publicly available domain name details:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<Whois DomainName="internetnz.net.nz" SourceIP="1.2.3.4"/>
</NZSRSRequest>
<NZSRSResponse VerMinor="4" VerMajor="6" RegistrarId="90">
<Response FeSeq="55552205" FeId="8" Action="Whois"
OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Year="2015" Month="01" Hour="13"
TimeZoneOffset="+13:00" Day="27" Second="35" Minute="08" />
<Domain Status="Active" Delegate="1" DomainName="internetnz.net.nz">
<NameServers>
<Server FQDN="ns1.dns.net.nz" />
<Server FQDN="ns2.dns.net.nz" />
<Server FQDN="ns3.dns.net.nz" />
<Server FQDN="ns4.dns.net.nz" />
</NameServers>
<RegistrantContact Name="NZ Domain Name Registry Limited"
Email="registry@internetnz.net.nz">
<PostalAddress Address2="P O Box 24361" PostalCode="6021"
Address1=".nz Registry Services" Province="Wellington"
City="Wellington" CountryCode="NZ" />
<Phone LocalNumber="9316970" AreaCode="4"
CountryCode="64" />
<Fax LocalNumber="9316979" AreaCode="4" CountryCode="64" />
</RegistrantContact>
<RegistrarPublicContact Name="Domain Name Commissioner"
Email="info@dnc.org.nz">
<PostalAddress Address1="PO Box 11881" City="Wellington"
CountryCode="NZ" />
<Phone LocalNumber="472-1600" AreaCode="4"
CountryCode="64" />
<Fax LocalNumber="495-2115" AreaCode="4"
CountryCode="64" />
</RegistrarPublicContact>
<AdminContact Name="NZ Domain Name Registry Limited"
Email="registry@internetnz.net.nz">
<PostalAddress Address2="P O Box 24361" PostalCode="6021"
Address1=".nz Registry Services" Province="Wellington"
City="Wellington" CountryCode="NZ" />
<Phone LocalNumber="9316970" AreaCode="4"
CountryCode="64" />
<Fax LocalNumber="9316979" AreaCode="4" CountryCode="64" />
</AdminContact>
<TechnicalContact Name="NZ Domain Name Registry Limited"
Email="registry@internetnz.net.nz">
<PostalAddress Address2="P O Box 24361" PostalCode="6021"
Address1=".nz Registry Services" Province="Wellington"
City="Wellington" CountryCode="NZ" />
<Phone LocalNumber="9316970" AreaCode="4"
CountryCode="64" />
<Fax LocalNumber="9316979" AreaCode="4" CountryCode="64" />
</TechnicalContact>
<BilledUntil Year="2015" Month="02" Hour="19"
TimeZoneOffset="+13:00" Day="07" Second="04" Minute="19" />
<RegisteredDate Year="2002" Month="07" Hour="19"
TimeZoneOffset="+12:00" Day="07" Second="04" Minute="19" />
<AuditDetails>
<AuditTime>
<From Year="2015" Month="01" Hour="23"
TimeZoneOffset="+13:00" Day="07" Second="42"
Minute="38" />
</AuditTime>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Whois request to query all publicly available domain name details with Registrant Privacy Flag set:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<Whois DomainName="internetnztest.co.nz"/>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="7" VerMinor="11">
<Response Action="Whois" FeId="7" FeSeq="1306240319" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="01" Hour="12" Minute="08" Month="09" Second="21" TimeZoneOffset="+12:00" Year="2017"/>
<Domain Delegate="1" DomainName="internetnztest.co.nz" Status="Active">
<NameServers>
<Server FQDN="ns1.internetnztest.co.nz" IP4Addr="8.8.8.8"/>
<Server FQDN="ns2.internetnztest.co.nz" IP4Addr="8.8.4.4"/>
</NameServers>
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress CountryCode="NZ"/>
</RegistrantContact>
<RegistrarPublicContact Email="PublicEmail@srs.net.nz" Name="PublicName">
<PostalAddress Address1="PublicAddress1" City="PublicCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="PublicPhone"/>
</RegistrarPublicContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="28" Hour="15" Minute="05" Month="08" Second="35" TimeZoneOffset="+12:00" Year="2018"/>
<RegisteredDate Day="28" Hour="15" Minute="05" Month="08" Second="35" TimeZoneOffset="+12:00" Year="2017"/>
<AuditDetails>
<AuditTime>
<From Day="01" Hour="12" Minute="08" Month="09" Second="13" TimeZoneOffset="+12:00" Year="2017"/>
</AuditTime>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Whois to query of all publicly available domain name details, result when Registrant Privacy Flag is not set :
<NZSRSResponse RegistrarId="90" VerMajor="7" VerMinor="11">
<Response Action="Whois" FeId="7" FeSeq="1306240316" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="01" Hour="12" Minute="02" Month="09" Second="34" TimeZoneOffset="+12:00" Year="2017"/>
<Domain Delegate="1" DomainName="internetnztest.co.nz" Status="Active">
<NameServers>
<Server FQDN="ns1.internetnztest.co.nz" IP4Addr="8.8.8.8"/>
<Server FQDN="ns2.internetnztest.co.nz" IP4Addr="8.8.4.4"/>
</NameServers>
<RegistrantContact Email="test@internetnztest.co.nz" Name="John Smith">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<RegistrarPublicContact Email="PublicEmail@srs.net.nz" Name="PublicName">
<PostalAddress Address1="PublicAddress1" City="PublicCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="PublicPhone"/>
</RegistrarPublicContact>
<AdminContact Email="test@internetnztest.co.nz" Name="Admin Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnztest.co.nz" Name="Technical Manager, Internet New Zealand Inc">
<PostalAddress Address1="Level 9 Grand Arcade" Address2="Willis Street" City="Wellington" CountryCode="NZ" PostalCode="6001"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="28" Hour="15" Minute="05" Month="08" Second="35" TimeZoneOffset="+12:00" Year="2018"/>
<RegisteredDate Day="28" Hour="15" Minute="05" Month="08" Second="35" TimeZoneOffset="+12:00" Year="2017"/>
<AuditDetails>
<AuditTime>
<From Day="28" Hour="15" Minute="05" Month="08" Second="35" TimeZoneOffset="+12:00" Year="2017"/>
</AuditTime>
</AuditDetails>
</Domain>
</Response>
</NZSRSResponse>
Whois request to perform multiple availability checks:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<Whois DomainName="internetnz.co.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.net.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.org.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.ac.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.cri.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.gen.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.govt.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.iwi.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.mil.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.school.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.maori.nz" FullResult="0" SourceIP="1.2.3.4"/>
<Whois DomainName="internetnz.geek.nz" FullResult="0" SourceIP="1.2.3.4"/>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="7">
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.co.nz" Status="Active"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.net.nz" Status="Active"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.org.nz" Status="Active"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.ac.nz" Status="Available"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.cri.nz" Status="Available"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.gen.nz" Status="Available"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.govt.nz" Status="Available"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.iwi.nz" Status="Available"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.mil.nz" Status="Available"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.school.nz" Status="Available"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.maori.nz" Status="Available"/>
</Response>
<Response Action="Whois" FeId="8" FeSeq="60969077" OrigRegistrarId="1" RecipientRegistrarId="90">
<FeTimeStamp Day="04" Hour="15" Minute="37" Month="06" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
<Domain DomainName="internetnz.geek.nz" Status="Available"/>
</Response>
</NZSRSResponse>
UDAIValidQry¶
A UDAIValidQry validates that a given UDAI is correct and belongs to a registered domain name. Registrars are able to validate the UDAI for any domain name, regardless of whether they are the designated registrar for that domain name. A boolean value “1” in the response confirms the validity of a UDAI. A valid=”0” means a UDAI is not valid.
The UDAIValidQry element contains the following attributes:
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
DomainName |
yes |
|
UDAI |
yes |
Validate a UDAI for a domain name:
<NZSRSRequest RegistrarId="1" VerMajor="3" VerMinor="0">
<UDAIValidQry DomainName="internetnz.net.nz" UDAI="UGVez7bu"/>
</NZSRSRequest>
<NZSRSResponse RegistrarId="1" VerMajor="6" VerMinor="4">
<Response Action="UDAIValidQry" FeId="8" FeSeq="55553772" OrigRegistrarId="1" RecipientRegistrarId="1">
<FeTimeStamp Day="27" Hour="13" Minute="58" Month="01" Second="38" TimeZoneOffset="+13:00" Year="2015"/>
<UDAIValid Valid="1"/>
</Response>
</NZSRSResponse>
GetMessages¶
A message is the answer given by the SRS in response to a single transaction, this may be an error message or a successful response. The GetMessages transaction allows registrars to poll for messages they may have been unaware of or to confirm the status of a specific transaction that had been sent previously.
Messages can be actioned by the registry on the behalf of registrars, or actioned by other registrars transferring away domains. To query for these transactions, registrars need to set the OriginatingRegistrarId field to a special value OTHERS and with RecipientRegistrarId set to the registrar’s own RegistrarId. All the messages originating from the registry and other registrars within the TransDateRange (if specified) are returned. Registrars only have access to messages that have been generated for them.
If a GetMessages request is sent with RecipientRegistrarId and the OriginatingRegistrarId set to a registrar’s own RegistrarId, all messages originating from that RegistrarId within the TransDateRange (if specified) are returned.
The full transaction identifier is the combination of the registrar that initiated it (the originating registrar) and the ActionId that was given in the original transaction.
QueueMode¶
The QueueMode is an optional attribute that is by default set to “0”. When a GetMessages request is sent with QueueMode=”1” the transaction returns all messages that match the GetMessages criteria AND that have not been acknowledged by the AckMessages transaction yet.
Omitting the QueueMode attribute returns all messages matching the GetMessages criteria no matter if a specific message had been acknowledged via the AckMessage transaction or not.
<TypeFilter>¶
The TypeFilter element has an attribute ‘Type’ which can have the value ‘third-party’ or ‘server-generated-data’ . Using only the value ‘third-party’ returns similar results as using the ‘OTHERS’ value for the OriginatingRegistrarId attribute.
However used in combination with ‘server-generated-data’ the transaction returns all messages that match either value (third-party OR server-generated-data). While using the ‘OTHERS’ value in combination with ‘server-generated-data’ will only return transactions that caused the server to generate data AND that have been processed for the registrar but not by themselves (e.g. domain transfer to the registrar processed by the registry).
Currently the only relevant ‘server-generated-data’ is the UDAI, i.e. transactions where a UDAI is generated will be returned when querying with the filter ‘server-generated-data’ (domain create, domain transfer, registrant update) .
The GetMessages element contains the following attributes and child elements:
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
ActionId |
no* |
|
RecipientRegistrarId |
no |
Is the registrar id that manages domains at the time that they are updated (you always set this to your registrar ID) |
OriginatingRegistrarId |
no |
Is the registrar id that sends the requests that update the domains eg your Registrar ID, or the Registry and the RenewDomains job or other Registrars that transfer domains away from you. You set this to your registrar ID to get just the messages that relate to updates to domains that you have done. For the GetMessages request you set OriginatingRegistrarId to “OTHERS” to see all the messages that relate to updates of domains that you manage performed by other registrars (transfers away) or by the Registry. |
MaxResults |
no |
“100” |
SkipResults |
no |
“0” |
QueueMode |
no |
“0” |
<TransDateRange> |
no* |
|
<TypeFilter> |
no |
Note
Either an ActionId or a TransDateRange must be provided
GetMessages request which returns messages between the specified dates:
<NZSRSRequest RegistrarId="945" VerMajor="3" VerMinor="0">
<GetMessages OriginatingRegistrarId="945" RecipientRegistrarId="945">
<TransDateRange>
<From Day="25" Hour="11" Minute="0" Month="01" Second="0" Year="2015"/>
<To Day="25" Hour="11" Minute="10" Month="01" Second="0" Year="2015"/>
</TransDateRange>
</GetMessages>
</NZSRSRequest>
<NZSRSResponse RegistrarId="945" VerMajor="6" VerMinor="4">
<Response Action="GetMessages" FeId="8" FeSeq="55553989" OrigRegistrarId="1" RecipientRegistrarId="945" Rows="1">
<FeTimeStamp Day="27" Hour="14" Minute="14" Month="01" Second="58" TimeZoneOffset="+13:00" Year="2015"/>
<Response Action="DomainCreate" FeId="8" FeSeq="55494652" OrigRegistrarId="945" RecipientRegistrarId="945" TransId="testwhoisserver-setupclass-ts142213685924.co.nz-1422136859.24">
<FeTimeStamp Day="25" Hour="11" Minute="01" Month="01" Second="00" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="testwhoisserver-setupclass-ts142213685924.co.nz" RegistrantRef="ref" RegistrarId="945" Status="Active" Term="1" UDAI="">
<NameServers>
<Server FQDN="ns.co.nz"/>
<Server FQDN="ns2.co.nz"/>
</NameServers>
<RegistrantContact Email="test@test.co.nz" Name="test">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@test.co.nz" Name="Admin">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@test.co.nz" Name="Tech">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="25" Hour="11" Minute="01" Month="04" Second="00" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="25" Hour="11" Minute="01" Month="01" Second="00" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="testwhoisserver-setupclass-ts142213685924.co.nz-1422136859.24" RegistrarId="945">
<AuditTime>
<From Day="25" Hour="11" Minute="01" Month="01" Second="00" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[create new domain]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</Response>
</NZSRSResponse>
GetMessages request which returns a message with a specific ActionId:
<NZSRSRequest VerMajor="3" VerMinor="0" RegistrarId="945">
<GetMessages ActionId="testdomaincreate-test7-ts142200783129.co.nz-1422007831.29" />
</NZSRSRequest>
<NZSRSResponse RegistrarId="945" VerMajor="6" VerMinor="4">
<Response Action="GetMessages" FeId="8" FeSeq="55554325" OrigRegistrarId="1" RecipientRegistrarId="945" Rows="1">
<FeTimeStamp Day="27" Hour="14" Minute="35" Month="01" Second="42" TimeZoneOffset="+13:00" Year="2015"/>
<Response Action="DomainCreate" FeId="8" FeSeq="55441385" OrigRegistrarId="945" RecipientRegistrarId="945" TransId="testdomaincreate-test7-ts142200783129.co.nz-1422007831.29">
<FeTimeStamp Day="23" Hour="23" Minute="10" Month="01" Second="31" TimeZoneOffset="+13:00" Year="2015"/>
<Domain Delegate="1" DomainName="testdomaincreate-test7-ts142200783129.co.nz" RegistrantRef="ref" RegistrarId="945" Status="Active" Term="1" UDAI="">
<NameServers>
<Server FQDN="ns1.nameserva.co.nz"/>
<Server FQDN="ns2.nameserva.co.nz"/>
</NameServers>
<RegistrantContact Email="test@internetnz-test-domain.co.nz" Name="test">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrantContact>
<AdminContact Email="test@internetnz-test-domain.co.nz" Name="Admin">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</AdminContact>
<TechnicalContact Email="test@internetnz-test-domain.co.nz" Name="Tech">
<PostalAddress Address1="17" Address2="27" City="wtn" CountryCode="NZ" PostalCode="IE D2" Province="test"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</TechnicalContact>
<BilledUntil Day="23" Hour="23" Minute="10" Month="04" Second="31" TimeZoneOffset="+12:00" Year="2015"/>
<RegisteredDate Day="23" Hour="23" Minute="10" Month="01" Second="31" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="testdomaincreate-test7-ts142200783129.co.nz-1422007831.29" RegistrarId="945">
<AuditTime>
<From Day="23" Hour="23" Minute="10" Month="01" Second="31" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[create new domain]]></AuditText>
</AuditDetails>
</Domain>
</Response>
</Response>
</NZSRSResponse>
GetMessages request which returns messages originating from other registrars:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<GetMessages OriginatingRegistrarId="OTHERS" RecipientRegistrarId="90">
<TransDateRange>
<From Day="27" Hour="14" Minute="0" Month="01" Second="0" Year="2015"/>
<To Day="27" Hour="14" Minute="59" Month="01" Second="0" Year="2015"/>
</TransDateRange>
</GetMessages>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="GetMessages" FeId="8" FeSeq="55554592" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1">
<FeTimeStamp Day="27" Hour="14" Minute="52" Month="01" Second="44" TimeZoneOffset="+13:00" Year="2015"/>
<Response Action="DomainTransfer" FeId="8" FeSeq="55554557" OrigRegistrarId="1" RecipientRegistrarId="90" TransId="srstest-1_10885">
<FeTimeStamp Day="27" Hour="14" Minute="52" Month="01" Second="12" TimeZoneOffset="+13:00" Year="2015"/>
<DomainTransfer Day="27" Hour="14" Minute="52" Month="01" RegistrarName="InternetNZ Jenkins Registrar 946" Second="12" TimeZoneOffset="+13:00" Year="2015">
<TransferredDomain><![CDATA[gyo.ac.nz]]></TransferredDomain>
</DomainTransfer>
</Response>
</Response>
</NZSRSResponse>
GetMessages request with QueueMode, aTransDateRange and FilterType
Gives back all transactions for registrar 90 generated in the specified time frame that have not been acknowledged and that have been generated by a transaction run by another registrar (e.g. transfer away, renewal domain job, release domain job) as well as all transactions run by registrar 90 that caused the system to generate data (e.g correct DomainCreate generating an UDAI):
<NZSRSRequest RegistrarId="60" VerMajor="5" VerMinor="0">
<GetMessages MaxResults="1000" QueueMode="1" SkipResults="0">
<TransDateRange>
<From Day="27" Hour="14" Minute="0" Month="01" Second="0" Year="2015"/>
<To Day="27" Hour="14" Minute="59" Month="01" Second="0" Year="2015"/>
</TransDateRange>
<TypeFilter Type="third-party"/>
<TypeFilter Type="server-generated-data"/>
</GetMessages>
</NZSRSRequest>
<NZSRSResponse RegistrarId="60" VerMajor="6" VerMinor="4">
<Response Action="GetMessages" FeId="8" FeSeq="55554728" OrigRegistrarId="1" RecipientRegistrarId="60" Rows="1">
<FeTimeStamp Day="27" Hour="14" Minute="55" Month="01" Second="44" TimeZoneOffset="+13:00" Year="2015"/>
<Message Remaining="1">
<Response Action="DomainTransfer" FeId="8" FeSeq="55554557" OrigRegistrarId="1" RecipientRegistrarId="60" TransId="srstest-1_10885">
<FeTimeStamp Day="27" Hour="14" Minute="52" Month="01" Second="12" TimeZoneOffset="+13:00" Year="2015"/>
<DomainTransfer Day="27" Hour="14" Minute="52" Month="01" RegistrarName="InternetNZ Jenkins Registrar 946" Second="12" TimeZoneOffset="+13:00" Year="2015">
<TransferredDomain><![CDATA[gyo.ac.nz]]></TransferredDomain>
</DomainTransfer>
</Response>
</Message>
</Response>
</NZSRSResponse>
AckMessage¶
In the SRS, ‘messages’ (which are actually responses) are kept and can actually be queried unlimited times.
The AckMessage transaction allows the EPP concept of acknowledging messages that have been received from the system to make sure messages are pulled only once. Once a message has been acknowledged with the AckMessage transaction it will no longer be returned by the GetMessages transaction if the QueueMode attribute is set in the GetMessage query.
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
ActionId |
yes |
|
TransId |
yes |
ActionId of the transaction to be acknowledged |
OriginatingRegistrarId |
yes |
ID of registrar who generated transaction |
Acknowledges the message with ActionId (TransId) ‘SomeUniqueID’. The field ‘ActionId’ holds the value for the actual AckMessage transaction as AckMessage is also a writing action and all writing transactions in the SRS require an ActionId:
<NZSRSRequest RegistrarId="945" VerMajor="5" VerMinor="0">
<AckMessage ActionId="Acknowledges msg: testdomaincreate-test7-ts142200783129.co.nz-1422007831.29" OriginatingRegistrarId="945" TransId="testdomaincreate-test7-ts142200783129.co.nz-1422007831.29"/>
</NZSRSRequest>
<NZSRSResponse RegistrarId="945" VerMajor="6" VerMinor="4">
<Response Action="AckMessage" FeId="8" FeSeq="55554977" OrigRegistrarId="1" RecipientRegistrarId="945" TransId="Acknowledges msg: testdomaincreate-test7-ts142200783129.co.nz-1422007831.29">
<FeTimeStamp Day="27" Hour="15" Minute="07" Month="01" Second="26" TimeZoneOffset="+13:00" Year="2015"/>
<AckResponse OriginatingRegistrarId="945" TransId="testdomaincreate-test7-ts142200783129.co.nz-1422007831.29"/>
</Response>
</NZSRSResponse>
ActionDetailsQry¶
The ActionDetailsQry retrieves the original XML (RawRequest and RawResponse strings) of a request sent by a registrar. It is identified by the ActionId.
Registrars are only returned transactions performed by them, or performed by the Registry on their behalf.
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
ActionId |
yes |
Fetch original transaction request and response for a given actionID:
<NZSRSRequest VerMajor="3" VerMinor="0" RegistrarId="1">
<ActionDetailsQry ActionId="testdomaincreate-test7-ts142200783129.co.nz-1422007831.29"/>
</NZSRSRequest>
<?xml version="1.0" encoding="UTF-8"?>
<NZSRSResponse RegistrarId="945" VerMajor="6" VerMinor="4">
<Response Action="ActionDetailsQry" FeId="8" FeSeq="55555088" OrigRegistrarId="1" RecipientRegistrarId="945">
<FeTimeStamp Day="27" Hour="15" Minute="15" Month="01" Second="09" TimeZoneOffset="+13:00" Year="2015"/>
<RawRequest>
<XML><![CDATA[%3cNZSRSRequest+VerMajor%3d%221%22+VerMinor%3d%220%22+RegistrarId%3d%22945%22%3e%0a%09%3cDomainCreate+Term%3d%223%22+ActionId%3d%22testdomaincreate-test7-ts142200783129%2eco%2enz-1422007831%2e29%22+Delegate%3d%221%22+DomainName%3d%22testdomaincreate-test7-ts142200783129%2eco%2enz%22+RegistrantRef%3d%22ref%22%3e%0a%09%09%3cRegistrantContact+Name%3d%22test%22+Email%3d%22test%40test%2eco%2enz%22%3e%0a%09%09%09%3cPostalAddress+Address1%3d%2217%22+Address2%3d%2227%22+City%3d%22wtn%22+CountryCode%3d%22NZ%22+PostalCode%3d%22IE+D2%22+Province%3d%22test%22%2f%3e%0a%09%09%09%3cPhone+AreaCode%3d%2204%22+CountryCode%3d%2264%22+LocalNumber%3d%221234567%22%2f%3e%0a%09%09%09%3cFax+AreaCode%3d%2204%22+CountryCode%3d%2264%22+LocalNumber%3d%221234567%22%2f%3e%0a%09%09%3c%2fRegistrantContact%3e%0a%09%09%3cAdminContact+Name%3d%22Admin%22+Email%3d%22test%40test%2eco%2enz%22%3e%0a%09%09%09%3cPostalAddress+Address1%3d%2217%22+Address2%3d%2227%22+City%3d%22wtn%22+CountryCode%3d%22NZ%22+PostalCode%3d%22IE+D2%22+Province%3d%22test%22%2f%3e%0a%09%09%09%3cPhone+AreaCode%3d%2204%22+CountryCode%3d%2264%22+LocalNumber%3d%221234567%22%2f%3e%0a%09%09%09%3cFax+AreaCode%3d%2204%22+CountryCode%3d%2264%22+LocalNumber%3d%221234567%22%2f%3e%0a%09%09%3c%2fAdminContact%3e%0a%09%09%3cTechnicalContact+Name%3d%22Tech%22+Email%3d%22test%40test%2eco%2enz%22%3e%0a%09%09%09%3cPostalAddress+Address1%3d%2217%22+Address2%3d%2227%22+City%3d%22wtn%22+CountryCode%3d%22NZ%22+PostalCode%3d%22IE+D2%22+Province%3d%22test%22%2f%3e%0a%09%09%09%3cPhone+AreaCode%3d%2204%22+CountryCode%3d%2264%22+LocalNumber%3d%221234567%22%2f%3e%0a%09%09%09%3cFax+AreaCode%3d%2204%22+CountryCode%3d%2264%22+LocalNumber%3d%221234567%22%2f%3e%0a%09%09%3c%2fTechnicalContact%3e%0a%09%09%3cNameServers%3e%0a%09%09%09%3cServer+FQDN%3d%22ns1%2enameserva%2eco%2enz%22+IP4Addr%3d%22192%2e168%2e1%2e1%22%2f%3e%0a%09%09%09%3cServer+FQDN%3d%22ns2%2enameserva%2eco%2enz%2e%22+IP4Addr%3d%22192%2e168%2e2%2e2%22%2f%3e%0a%09%09%3c%2fNameServers%3e%0a%09%09%3cAuditText%3ecreate+new+domain%3c%2fAuditText%3e%0a%09%3c%2fDomainCreate%3e%0a%3c%2fNZSRSRequest%3e]]></XML>
<Signature><![CDATA[-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
iQIcBAABAgAGBQJUwh4XAAoJEJ3tz3mBZeI5xzUP/0gmbzZWPoozkU0PtT8O/tpq
0ZGZ9+ZGRzeFwfkUuq80/w0FL/li1mtCWctrPti/nogULwu4W3W03AP9YO6I+NXB
UOcSKB7lDDv8iKd3HbrK6wIuCfyfgPo+D+/7/bCAs0YuyqtYVnT6jN11tkxqQCPO
iSHYuGxUbRS4U7+D9DjUIywAQFaSIUoRlnLupKJrTGHzoZyvTaQxCPNEuWCRQnWS
Ui6WsgyAfze4zu48bFPX1j6r2aSTRyk9qTMdHvrsawwu8b5Loco01i5uJG1hnsUX
lUY9Im/p4gXpULoK8jReXPulQlWlTXfEsquUMcEMR/8WbB1F7RU9eF+vJL0IxK6H
pXCotZYJr+7Jzpjqsyu2omrZmxMGCXwHW1af+AURTAr6gUAap10PokrszYnVyZZg
PTqc07Z/KnCW3+116de6TqExaajgsrdBQ+Gy+qbo14acyOqneKRm+ER2esqmUsZ3
fszbLkSYBXCW1yNOI2ccM3FiSg7FjXcdwNBjprex6agh71T++hvsNP1hOWRsjnDQ
IiilrikCyT89bai6x0fzcGwFo26OpySX9FfUZdRKSf9bdqqTNvi4o8HXNjcRn9oS
iYjoBV6CugCO7oxoCs7gVPgZpufpMJZBo51+kaV0wgPxWSwr+k0PoSq2GaKHJUL3
3E8wF9kOygs8agtzAxtI
=7Z63
-----END PGP SIGNATURE-----
]]></Signature>
</RawRequest>
<RawResponse>
<XML><![CDATA[%3c%3fxml+version%3d%221%2e0%22+encoding%3d%22UTF-8%22%3f%3e%0a%3cNZSRSResponse+VerMinor%3d%224%22+VerMajor%3d%226%22+RegistrarId%3d%22945%22%3e%3cResponse+TransId%3d%22testdomaincreate-test7-ts142200783129%2eco%2enz-1422007831%2e29%22+FeSeq%3d%2255441385%22+FeId%3d%228%22+Action%3d%22DomainCreate%22+OrigRegistrarId%3d%22945%22+RecipientRegistrarId%3d%22945%22%3e%3cFeTimeStamp+Year%3d%222015%22+Month%3d%2201%22+Hour%3d%2223%22+TimeZoneOffset%3d%22%2b13%3a00%22+Day%3d%2223%22+Second%3d%2231%22+Minute%3d%2210%22%2f%3e%3cDomain+Status%3d%22Active%22+Term%3d%221%22+RegistrarId%3d%22945%22+Delegate%3d%221%22+UDAI%3d%22%22+DomainName%3d%22testdomaincreate-test7-ts142200783129%2eco%2enz%22+RegistrantRef%3d%22ref%22%3e%3cNameServers%3e%3cServer+FQDN%3d%22ns1%2enameserva%2eco%2enz%22%2f%3e%3cServer+FQDN%3d%22ns2%2enameserva%2eco%2enz%22%2f%3e%3c%2fNameServers%3e%3cRegistrantContact+Name%3d%22test%22+Email%3d%22test%40test%2eco%2enz%22%3e%3cPostalAddress+Address2%3d%2227%22+PostalCode%3d%22IE+D2%22+Address1%3d%2217%22+Province%3d%22test%22+City%3d%22wtn%22+CountryCode%3d%22NZ%22%2f%3e%3cPhone+LocalNumber%3d%221234567%22+AreaCode%3d%224%22+CountryCode%3d%2264%22%2f%3e%3cFax+LocalNumber%3d%221234567%22+AreaCode%3d%224%22+CountryCode%3d%2264%22%2f%3e%3c%2fRegistrantContact%3e%3cAdminContact+Name%3d%22Admin%22+Email%3d%22test%40test%2eco%2enz%22%3e%3cPostalAddress+Address2%3d%2227%22+PostalCode%3d%22IE+D2%22+Address1%3d%2217%22+Province%3d%22test%22+City%3d%22wtn%22+CountryCode%3d%22NZ%22%2f%3e%3cPhone+LocalNumber%3d%221234567%22+AreaCode%3d%224%22+CountryCode%3d%2264%22%2f%3e%3cFax+LocalNumber%3d%221234567%22+AreaCode%3d%224%22+CountryCode%3d%2264%22%2f%3e%3c%2fAdminContact%3e%3cTechnicalContact+Name%3d%22Tech%22+Email%3d%22test%40test%2eco%2enz%22%3e%3cPostalAddress+Address2%3d%2227%22+PostalCode%3d%22IE+D2%22+Address1%3d%2217%22+Province%3d%22test%22+City%3d%22wtn%22+CountryCode%3d%22NZ%22%2f%3e%3cPhone+LocalNumber%3d%221234567%22+AreaCode%3d%224%22+CountryCode%3d%2264%22%2f%3e%3cFax+LocalNumber%3d%221234567%22+AreaCode%3d%224%22+CountryCode%3d%2264%22%2f%3e%3c%2fTechnicalContact%3e%3cBilledUntil+Year%3d%222015%22+Month%3d%2204%22+Hour%3d%2223%22+TimeZoneOffset%3d%22%2b12%3a00%22+Day%3d%2223%22+Second%3d%2231%22+Minute%3d%2210%22%2f%3e%3cRegisteredDate+Year%3d%222015%22+Month%3d%2201%22+Hour%3d%2223%22+TimeZoneOffset%3d%22%2b13%3a00%22+Day%3d%2223%22+Second%3d%2231%22+Minute%3d%2210%22%2f%3e%3cAuditDetails+ActionId%3d%22testdomaincreate-test7-ts142200783129%2eco%2enz-1422007831%2e29%22+RegistrarId%3d%22945%22%3e%3cAuditTime%3e%3cFrom+Year%3d%222015%22+Month%3d%2201%22+Hour%3d%2223%22+TimeZoneOffset%3d%22%2b13%3a00%22+Day%3d%2223%22+Second%3d%2231%22+Minute%3d%2210%22%2f%3e%3c%2fAuditTime%3e%3cAuditText%3e%3c%21%5bCDATA%5bcreate+new+domain%5d%5d%3e%3c%2fAuditText%3e%3c%2fAuditDetails%3e%3c%2fDomain%3e%3c%2fResponse%3e%3c%2fNZSRSResponse%3e]]></XML>
<Signature><![CDATA[not stored]]></Signature>
</RawResponse>
</Response>
</NZSRSResponse>
HandleCreate¶
The HandleCreate transaction allows registrars to create a new SRS contact handle. The SRS handle is generated immediately and can be used in DomainCreate, DomainUpdate or RegistrarUpdate transactions.
Transaction elements and attributes for a <HandleCreate>
Name |
Required |
|---|---|
HandleId |
yes |
ActionId |
yes |
Name |
yes |
yes |
|
Privacy |
no |
<PostalAddress> |
yes |
<Phone> |
yes |
<Fax> |
no |
AuditText |
no |
HandleCreate with all available fields populated:
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<HandleCreate ActionId="handle_create_1-2015" Email="new@internetnz-test-registrant.co.nz" HandleId="customer-1000" Name="Registrant Name">
<PostalAddress Address1="Registrant Address 1" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<AuditText>Create a Handle</AuditText>
</HandleCreate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="HandleCreate" FeId="8" FeSeq="55556057" OrigRegistrarId="90" RecipientRegistrarId="90" Rows="1" TransId="handle_create_1-2015">
<FeTimeStamp Day="27" Hour="16" Minute="04" Month="01" Second="36" TimeZoneOffset="+13:00" Year="2015"/>
<Handle Email="new@internetnz-test-registrant.co.nz" HandleId="customer-1000" Name="Registrant Name" RegistrarId="90">
<PostalAddress Address1="Registrant Address 1" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<CreatedDate Day="27" Hour="16" Minute="04" Month="01" Second="36" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="handle_create_1-2015" RegistrarId="90">
<AuditTime>
<From Day="27" Hour="16" Minute="04" Month="01" Second="36" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[Create a Handle]]></AuditText>
</AuditDetails>
</Handle>
</Response>
</NZSRSResponse>
HandleCreate with Privacy
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<HandleCreate ActionId="handle_create_privacy" Email="new@internetnz-test-registrant.co.nz" HandleId="customer-1000" Name="Registrant Name" Privacy="1">
<PostalAddress Address1="Registrant Address 1" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<AuditText>Create a Handle</AuditText>
</HandleCreate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="7" VerMinor="11">
<Response Action="HandleCreate" FeId="7" FeSeq="1306228915" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="handle_create_privacy">
<FeTimeStamp Day="30" Hour="16" Minute="10" Month="08" Second="10" TimeZoneOffset="+12:00" Year="2017"/>
<Handle Email="new@internetnz-test-registrant.co.nz" HandleId="customer-1000" Name="Registrant Name" Privacy="1" RegistrarId="90">
<PostalAddress Address1="Registrant Address 1" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<CreatedDate Day="30" Hour="16" Minute="10" Month="08" Second="10" TimeZoneOffset="+12:00" Year="2017"/>
<AuditDetails ActionId="handle_create_privacy" RegistrarId="1">
<AuditTime>
<From Day="30" Hour="16" Minute="10" Month="08" Second="10" TimeZoneOffset="+12:00" Year="2017"/>
</AuditTime>
<AuditText>
<![CDATA[Create a Handle]]>
</AuditText>
</AuditDetails>
</Handle>
</Response>
</NZSRSResponse>
HandleUpdate¶
HandleUpdate allows registrars to update existing handles.
If handles are used and the registrant name for several domain names is to be updated, we recommend to create a new handle and perform a DomainUpdate request for the relevant domain names to associate the new handle with the domains. This approach makes changes more visible and therefore registrars have more control over the actual changes.
Also with an HandleUpdate orphaned handles that are no longer required can be deleted. Deletion is only possible if a handle is not associated with any domain name or registrar object. Otherwise an error will be returned.
Updates:
All fields but the HandleId can be updated with a HandleUpdate transaction. An update of handle details results in the change of contact details of all domain names the handle is linked to. Note: If a handle is linked to the Registrant Contact of one or more domain names the update of the handle’s name field results in a registrant change of the domain name(s).
If a SRS handle is updated linked to a domain name that has the status PendingRelease the contact details of that domain name will be updated. This behavior currently differs from a DomainUpdate for a domain name with status PendingRelease. Trying to update the contact details via a DomainUpdate returns an error advising only active domain names can be updated.
Domain names locked by the registry will not be effected by any HandleUpdates for the time they are locked. The system will keep a ‘snapshot’ of domain details as at the time of the lock. If a HandleUpdate occurs while a domain name is locked the domain name will only be updated with the new handle details once the domain name is unlocked (unless the domain name gets updated by the registry as result of any dispute resolution actions)
Transaction elements and attributes for <HandleUpdate>
Name |
Required |
Default |
|---|---|---|
HandleId |
yes |
|
ActionId |
yes |
|
Delete |
no |
“0” (no) |
Name |
yes |
|
yes |
||
Privacy |
no |
“0” |
<PostalAddress> |
no |
|
<Phone> |
no |
|
<Fax> |
no |
|
AuditText |
no |
HandleUpdate that updates Postal and Phone details:
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<HandleUpdate ActionId="update_handle_1_1" Email="new@sample-domain.co.nz" HandleId="customer-1000" Name="Registrant Name">
<PostalAddress Address1="Registrant New Address" City="Wellington" CountryCode="NZ"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<AuditText>Update a Handle</AuditText>
</HandleUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="HandleUpdate" FeId="8" FeSeq="55556090" OrigRegistrarId="90" RecipientRegistrarId="90" Rows="1" TransId="update_handle_1_1">
<FeTimeStamp Day="27" Hour="16" Minute="07" Month="01" Second="50" TimeZoneOffset="+13:00" Year="2015"/>
<Handle Email="new@sample-domain.co.nz" HandleId="customer-1000" Name="Registrant Name" RegistrarId="90">
<PostalAddress Address1="Registrant New Address" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<CreatedDate Day="27" Hour="16" Minute="04" Month="01" Second="36" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="update_handle_1_1" RegistrarId="90">
<AuditTime>
<From Day="27" Hour="16" Minute="07" Month="01" Second="50" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[Update a Handle]]></AuditText>
</AuditDetails>
</Handle>
</Response>
</NZSRSResponse>
HandleUpdate for Privacy
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<HandleUpdate ActionId="update_handle" HandleId="customer-1000" Privacy="1">
<AuditText>Update a Handle</AuditText>
</HandleUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="7" VerMinor="11">
<Response Action="HandleUpdate" FeId="7" FeSeq="1306228919" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1" TransId="update_handle">
<FeTimeStamp Day="30" Hour="16" Minute="27" Month="08" Second="43" TimeZoneOffset="+12:00" Year="2017"/>
<Handle Email="new@internetnz-test-registrant.co.nz" HandleId="customer-1000" Name="Registrant Name" Privacy="1" RegistrarId="90">
<PostalAddress Address1="Registrant Address 1" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<CreatedDate Day="30" Hour="16" Minute="10" Month="08" Second="10" TimeZoneOffset="+12:00" Year="2017"/>
<AuditDetails ActionId="update_handle" RegistrarId="1">
<AuditTime>
<From Day="30" Hour="16" Minute="27" Month="08" Second="43" TimeZoneOffset="+12:00" Year="2017"/>
</AuditTime>
<AuditText>
<![CDATA[Update a Handle]]>
</AuditText>
</AuditDetails>
</Handle>
</Response>
</NZSRSResponse>
HandleUpdate that deletes a handle:
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<HandleUpdate ActionId="Delete customer-1001" Delete="1" HandleId="customer-1001">
<AuditText>Delete a Handle</AuditText>
</HandleUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="HandleUpdate" FeId="8" FeSeq="55556120" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="0" TransId="Delete customer-1001">
<FeTimeStamp Day="27" Hour="16" Minute="09" Month="01" Second="40" TimeZoneOffset="+13:00" Year="2015"/>
</Response>
</NZSRSResponse>
HandleDetailsQry¶
Similar to the DomainDetailsQry transaction the HandleDetailsQry enables registrars to do a variety of different queries on current and historical data of handles. Registrars can only query handles and history of handles that are/were managed by them.
The HandleDetailsQry provides the functionality and flexibility for a variety of different uses. It allows partial field matching and date dependencies using date range fields.
Wildcards (“*” for full words and more than two letters and “?” for single letters) can be used for the <ContactFilter> attributes.
Transaction elements and attributes for <HandleDetailsQry>
Name |
Required |
Default |
|---|---|---|
CountResults |
no |
“0” |
MaxResults |
no |
“100” |
SkipResults |
no |
“0” |
HandleIdFilter |
no |
|
SearchDateRange |
no |
|
ChangedInDateRange |
no |
|
ContactFilter |
no |
Simple HandleDetailsQry that gives back the first 100 handles existing with registrar 90:
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<HandleDetailsQry MaxResults="100" SkipResults="0"/>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="HandleDetailsQry" FeId="8" FeSeq="55556204" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1">
<FeTimeStamp Day="27" Hour="16" Minute="15" Month="01" Second="46" TimeZoneOffset="+13:00" Year="2015"/>
<Handle Email="new@sample-domain.co.nz" HandleId="customer-1000" Name="Registrant Name" RegistrarId="90">
<PostalAddress Address1="Registrant New Address" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<CreatedDate Day="27" Hour="16" Minute="04" Month="01" Second="36" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="update_handle_1_1" RegistrarId="90">
<AuditTime>
<From Day="27" Hour="16" Minute="07" Month="01" Second="50" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[Update a Handle]]></AuditText>
</AuditDetails>
</Handle>
</Response>
</NZSRSResponse>
Simple HandleDetailsQry that counts all handles existing with registrar 90:
<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
<HandleDetailsQry CountResults="1"/>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="HandleDetailsQry" Count="1" FeId="8" FeSeq="55556382" OrigRegistrarId="90" RecipientRegistrarId="90" Rows="0">
<FeTimeStamp Day="27" Hour="16" Minute="21" Month="01" Second="49" TimeZoneOffset="+13:00" Year="2015"/>
</Response>
</NZSRSResponse>
HandleDetailsQry searching for SRS handles that have a name contact starting with “Registrant” and Address line 1 ending with “Address”:
<NZSRSRequest RegistrarId="90" VerMajor="1" VerMinor="0">
<HandleDetailsQry>
<ContactFilter Name="Registrant*">
<PostalAddressFilter Address1="*Address"/>
</ContactFilter>
</HandleDetailsQry>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="HandleDetailsQry" FeId="8" FeSeq="55556421" OrigRegistrarId="90" RecipientRegistrarId="90" Rows="1">
<FeTimeStamp Day="27" Hour="16" Minute="25" Month="01" Second="54" TimeZoneOffset="+13:00" Year="2015"/>
<Handle Email="new@sample-domain.co.nz" HandleId="customer-1000" Name="Registrant Name" RegistrarId="90">
<PostalAddress Address1="Registrant New Address" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<CreatedDate Day="27" Hour="16" Minute="04" Month="01" Second="36" TimeZoneOffset="+13:00" Year="2015"/>
<AuditDetails ActionId="update_handle_1_1" RegistrarId="90">
<AuditTime>
<From Day="27" Hour="16" Minute="07" Month="01" Second="50" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[Update a Handle]]></AuditText>
</AuditDetails>
</Handle>
</Response>
</NZSRSResponse>
HandleDetailsQry of a single handle showing privacy
<NZSRSRequest RegistrarId="90" VerMajor="1" VerMinor="0">
<HandleDetailsQry>
<HandleIdFilter>customer-1000</HandleIdFilter>
</HandleDetailsQry>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="7" VerMinor="11">
<Response Action="HandleDetailsQry" FeId="7" FeSeq="1306228935" OrigRegistrarId="1" RecipientRegistrarId="90" Rows="1">
<FeTimeStamp Day="30" Hour="16" Minute="52" Month="08" Second="18" TimeZoneOffset="+12:00" Year="2017"/>
<Handle Email="new@internetnz-test-registrant.co.nz" HandleId="customer-1000" Name="Registrant Name" Privacy="1" RegistrarId="90">
<PostalAddress Address1="Registrant Address 1" Address2="Registrant Address 2" City="Wellington" CountryCode="NZ" PostalCode="1234" Province="Wellington"/>
<Phone AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<Fax AreaCode="1" CountryCode="64" LocalNumber="23456"/>
<CreatedDate Day="30" Hour="16" Minute="10" Month="08" Second="10" TimeZoneOffset="+12:00" Year="2017"/>
<AuditDetails ActionId="update_handle 2" RegistrarId="1">
<AuditTime>
<From Day="30" Hour="16" Minute="51" Month="08" Second="55" TimeZoneOffset="+12:00" Year="2017"/>
</AuditTime>
<AuditText>
<![CDATA[Update a Handle]]>
</AuditText>
</AuditDetails>
</Handle>
</Response>
</NZSRSResponse>
RegistrarAccountQry¶
Registrars are able to query all their Billing Transactions in the SRS by using the RegistrarAccountQry. By providing search criteria, registrars are able to filter the query results to fit their needs.
Registrars can query:
All transactions in a date range
All details relating to a specific domain
All details relating to a single customer of the Registrar (identified by the Registrant Customer Reference - if these details have been provided for the domain name)
Any combination of the above
Wild-card (*) searching is possible for the DomainName field.
Please note that this calculation is performed each time the query is executed, and if the database changes between executions, it is possible that transactions are missed or duplicated in the result.
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
DomainName |
no |
|
RegistrantRef |
no |
|
MaxResults |
no |
“100” |
SkipResults |
no |
“0” |
TransDateRange |
no |
A RegistrarAccountQry to find the account details of one domain name. (Use the wildcard (*) to find all acount details of the registrar):
<NZSRSRequest VerMajor="3" VerMinor="0" RegistrarId="945">
<RegistrarAccountQry DomainName="testdomaincreate-test7-ts142200783129.co.nz" MaxResults="10" SkipResults="0" />
</NZSRSRequest>
<NZSRSResponse RegistrarId="945" VerMajor="6" VerMinor="4">
<Response Action="RegistrarAccountQry" FeId="8" FeSeq="55555374" OrigRegistrarId="1" RecipientRegistrarId="945" Rows="1">
<FeTimeStamp Day="27" Hour="15" Minute="30" Month="01" Second="18" TimeZoneOffset="+13:00" Year="2015"/>
<BillingTrans Amount="3.75" BillingTerm="3" DomainName="testdomaincreate-test7-ts142200783129.co.nz" RegistrantRef="ref" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="23" Hour="23" Minute="10" Month="01" Second="31" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="23" Hour="23" Minute="10" Month="01" Second="31" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="23" Hour="23" Minute="10" Month="04" Second="31" TimeZoneOffset="+12:00" Year="2015"/>
</BillingTrans>
</Response>
</NZSRSResponse>
A RegistrarAccountQry using the TransDateRange to search for all account information between the specified dates (in this case one month):
<NZSRSRequest RegistrarId="945" VerMajor="3" VerMinor="0">
<RegistrarAccountQry MaxResults="1500" SkipResults="0">
<TransDateRange>
<From Day="27" Hour="14" Minute="0" Month="01" Second="0" Year="2015"/>
<To Day="27" Hour="14" Minute="45" Month="01" Second="0" Year="2015"/>
</TransDateRange>
</RegistrarAccountQry>
</NZSRSRequest>
<NZSRSResponse RegistrarId="945" VerMajor="6" VerMinor="4">
<Response Action="RegistrarAccountQry" FeId="8" FeSeq="55555419" OrigRegistrarId="1" RecipientRegistrarId="945" Rows="8">
<FeTimeStamp Day="27" Hour="15" Minute="34" Month="01" Second="03" TimeZoneOffset="+13:00" Year="2015"/>
<BillingTrans Amount="3.75" BillingTerm="3" DomainName="testdomaincreate-test7-ts142232106448.co.nz" RegistrantRef="ref" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="27" Hour="14" Minute="11" Month="01" Second="04" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="27" Hour="14" Minute="11" Month="01" Second="04" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="27" Hour="14" Minute="11" Month="04" Second="04" TimeZoneOffset="+12:00" Year="2015"/>
</BillingTrans>
<BillingTrans Amount="3.75" BillingTerm="3" DomainName="testdomaincreate-test5-ts142232106226.co.nz" RegistrantRef="ref" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="27" Hour="14" Minute="11" Month="01" Second="02" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="27" Hour="14" Minute="11" Month="01" Second="02" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="27" Hour="14" Minute="11" Month="04" Second="02" TimeZoneOffset="+12:00" Year="2015"/>
</BillingTrans>
<BillingTrans Amount="3.75" BillingTerm="3" DomainName="xn--testdomancreate-test4dn-ts142232106048-1pfn.co.nz" RegistrantRef="ref" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="27" Hour="14" Minute="11" Month="01" Second="01" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="27" Hour="14" Minute="11" Month="01" Second="01" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="27" Hour="14" Minute="11" Month="04" Second="01" TimeZoneOffset="+12:00" Year="2015"/>
</BillingTrans>
<BillingTrans Amount="1.25" BillingTerm="1" DomainName="testdomaincreate-test3registrantadminhandles-ts14223210590.co.nz" RegistrantRef="ref" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="27" Hour="14" Minute="10" Month="01" Second="59" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="27" Hour="14" Minute="10" Month="01" Second="59" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="27" Hour="14" Minute="10" Month="02" Second="59" TimeZoneOffset="+13:00" Year="2015"/>
</BillingTrans>
<BillingTrans Amount="3.75" BillingTerm="3" DomainName="testdomaincreate-test2allfields-ts142232105743.co.nz" RegistrantRef="ref" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="27" Hour="14" Minute="10" Month="01" Second="57" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="27" Hour="14" Minute="10" Month="01" Second="57" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="27" Hour="14" Minute="10" Month="04" Second="57" TimeZoneOffset="+12:00" Year="2015"/>
</BillingTrans>
<BillingTrans Amount="15.00" BillingTerm="12" DomainName="testdomaincreate-test1mandatory-ts142232105606.co.nz" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="27" Hour="14" Minute="10" Month="01" Second="56" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="27" Hour="14" Minute="10" Month="01" Second="56" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="27" Hour="14" Minute="10" Month="01" Second="56" TimeZoneOffset="+13:00" Year="2016"/>
</BillingTrans>
<BillingTrans Amount="15.00" BillingTerm="12" DomainName="testdomaindetailsqry-setupclass-ts142232103994.co.nz" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="27" Hour="14" Minute="10" Month="01" Second="40" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="27" Hour="14" Minute="10" Month="01" Second="40" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="27" Hour="14" Minute="10" Month="01" Second="40" TimeZoneOffset="+13:00" Year="2016"/>
</BillingTrans>
<BillingTrans Amount="3.75" BillingTerm="3" DomainName="testwhoisserver-setupclass-ts142232046841.co.nz" RegistrantRef="ref" RegistrarId="945" TransStatus="PendingConfirmation" Type="Create">
<TransDate Day="27" Hour="14" Minute="01" Month="01" Second="08" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodStart Day="27" Hour="14" Minute="01" Month="01" Second="08" TimeZoneOffset="+13:00" Year="2015"/>
<BillPeriodEnd Day="27" Hour="14" Minute="01" Month="04" Second="08" TimeZoneOffset="+12:00" Year="2015"/>
</BillingTrans>
</Response>
</NZSRSResponse>
The following set of Billing details are returned:
Attribute / <Element> |
Details |
|---|---|
RecipientRegistrarId |
The unique identifier for the user that the response is returned to |
OrigRegistrarId |
The unique identifier for the user that submitted the request to the SRS |
Amount |
A numeric currency value. The amount of money attached to the billing transaction |
BillingTerm |
An integer value that shows the number of months of payment for which the billing transaction was issued |
DomainName |
The domain name that the billing transaction relates to |
RegistrantRef |
The customer identifier, a reference that may be assigned to the registrant by the registrar (has to be provided during DomainCreate or DomainUpdate) |
RegistrarId |
The identifier of the registrar that manages the domain that the billing amount relates to |
TransStatus |
A text string that shows the status of the billing transaction (always “Pending-Confirmation” as a billing transaction is always pending at the time it was created due to grace periods) |
Type |
The type of transaction that the billing amount relates to (e.g. ”Create”, ”Renew”) |
TransDate |
The date on which the billing transaction occurred |
BilledPeriodStart |
Contains the start date of the billing period to which the transaction belongs |
BilledPeriodEnd |
Contains the end date of the billing period to which the transaction belongs |
RegistrarDetailsQry¶
The RegistrarDetailsQry retrieves information of a registrar contact details stored in the SRS.
A registrar is only allowed to query for their own data.
The ResultsDateRange causes the results to return multiple records for the registrar, describing all the changes that the registrar went through during the effective period. This is an optional parameter. Omitting it will cause only the latest data for the registrar that matches the filters to be returned.
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
ResultDateRange (From, To) |
no |
current date |
Return all current details for a domain:
<NZSRSRequest VerMajor="3" VerMinor="0" RegistrarId="945">
<RegistrarDetailsQry RegistrarId="3"/>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="RegistrarDetailsQry" FeId="8" FeSeq="55555567" OrigRegistrarId="90" RecipientRegistrarId="90" Rows="1">
<FeTimeStamp Day="27" Hour="15" Minute="48" Month="01" Second="26" TimeZoneOffset="+13:00" Year="2015"/>
<Registrar AccRef="SRS" Name="Test Registrar" RegistrarId="90" URL="www.srs.net.nz">
<RegistrarPublicContact Email="PublicEmail@srs.net.nz" Name="PublicName">
<PostalAddress Address1="PublicAddress1" City="PublicCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="PublicPhone"/>
</RegistrarPublicContact>
<RegistrarSRSContact Email="SRSEmail@srs.net.nz" Name="SRSName">
<PostalAddress Address1="SRSAddress1" City="SRSCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="SRSPhone"/>
</RegistrarSRSContact>
<DefaultTechnicalContact Email="DefaultEmail@srs.net.nz" Name="DefaultName">
<PostalAddress Address1="DefaultAddress1" City="DefaultCity" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="DefaultPhone"/>
</DefaultTechnicalContact>
<EncryptKeys/>
<Allowed2LDs>
<SecondLD DomainName="ac.nz"/>
<SecondLD DomainName="co.nz"/>
<SecondLD DomainName="cri.nz"/>
<SecondLD DomainName="geek.nz"/>
<SecondLD DomainName="gen.nz"/>
<SecondLD DomainName="govt.nz"/>
<SecondLD DomainName="health.nz"/>
<SecondLD DomainName="iwi.nz"/>
<SecondLD DomainName="kiwi.nz"/>
<SecondLD DomainName="maori.nz"/>
<SecondLD DomainName="mil.nz"/>
<SecondLD DomainName="net.nz"/>
<SecondLD DomainName="nz"/>
<SecondLD DomainName="org.nz"/>
<SecondLD DomainName="parliament.nz"/>
<SecondLD DomainName="school.nz"/>
</Allowed2LDs>
<Roles>
<Role RoleName="CancelDomain"/>
<Role RoleName="Connect"/>
<Role RoleName="CreateDomain"/>
<Role RoleName="Query"/>
<Role RoleName="Registrar"/>
<Role RoleName="TransferDomain"/>
<Role RoleName="UncancelDomain"/>
<Role RoleName="UpdateDomain"/>
<Role RoleName="UpdateRegistrar"/>
<Role RoleName="Whois"/>
</Roles>
<AuditDetails ActionId="InitialiseRegistrar90" RegistrarId="50">
<AuditTime>
<From Day="23" Hour="08" Minute="47" Month="01" Second="30" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
<AuditText><![CDATA[Set up Registrar 90 for testing]]></AuditText>
</AuditDetails>
</Registrar>
</Response>
</NZSRSResponse>
RegistrarUpdate¶
The RegistrarUpdate transaction enables registrar to update their contact details.
All but the following fields can be updated by the registrar:
2LDs
public key
access role list
Registrar Name
Registrar Accounting Reference
If a you want us to update or add another public key please contact registry@internetnz.net.nz
A registrar’s DefaultTechnicalContact details are used for all domain names the registrar administers which have no other technical contact specified.
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
ActionId |
yes |
|
RegistrarPublicContact |
no |
|
RegistrarSRSContact |
no |
|
DefaultTechnicalContact |
no |
|
URL |
no |
Example:
<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
<RegistrarUpdate ActionId="2015-01-27-update-roles">
<RegistrarPublicContact Email="test@internetnz-sample-domain.co.nz" Name="public_contact">
<PostalAddress Address1="PO BOX 12345" Address2="Postshop" City="wtn" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrarPublicContact>
<RegistrarSRSContact Email="test@internetnz-sample-domain.co.nz" Name="srsname">
<PostalAddress Address1="Level 10" Address2="21 Somestreet" City="wtn" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrarSRSContact>
<DefaultTechnicalContact Email="test@internetnz-sample-domain.co.nz" Name="tech_name">
<PostalAddress Address1="PO BOX 12345" Address2="Postshop" City="wn" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</DefaultTechnicalContact>
</RegistrarUpdate>
</NZSRSRequest>
<NZSRSResponse RegistrarId="90" VerMajor="6" VerMinor="4">
<Response Action="RegistrarUpdate" FeId="8" FeSeq="55555897" OrigRegistrarId="90" RecipientRegistrarId="90" TransId="2015-01-27-update-roles">
<FeTimeStamp Day="27" Hour="15" Minute="56" Month="01" Second="55" TimeZoneOffset="+13:00" Year="2015"/>
<Registrar AccRef="SRS" Name="Test Registrar" RegistrarId="90" URL="www.srs.net.nz">
<RegistrarPublicContact Email="test@internetnz-sample-domain.co.nz" Name="public_contact">
<PostalAddress Address1="PO BOX 12345" Address2="Postshop" City="wtn" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrarPublicContact>
<RegistrarSRSContact Email="test@internetnz-sample-domain.co.nz" Name="srsname">
<PostalAddress Address1="Level 10" Address2="21 Somestreet" City="wtn" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</RegistrarSRSContact>
<DefaultTechnicalContact Email="test@internetnz-sample-domain.co.nz" Name="tech_name">
<PostalAddress Address1="PO BOX 12345" Address2="Postshop" City="wn" CountryCode="NZ"/>
<Phone AreaCode="4" CountryCode="64" LocalNumber="123-4567"/>
<Fax AreaCode="4" CountryCode="64" LocalNumber="1234567"/>
</DefaultTechnicalContact>
<EncryptKeys/>
<Allowed2LDs>
<SecondLD DomainName="ac.nz"/>
<SecondLD DomainName="co.nz"/>
<SecondLD DomainName="cri.nz"/>
<SecondLD DomainName="geek.nz"/>
<SecondLD DomainName="gen.nz"/>
<SecondLD DomainName="govt.nz"/>
<SecondLD DomainName="health.nz"/>
<SecondLD DomainName="iwi.nz"/>
<SecondLD DomainName="kiwi.nz"/>
<SecondLD DomainName="maori.nz"/>
<SecondLD DomainName="mil.nz"/>
<SecondLD DomainName="net.nz"/>
<SecondLD DomainName="nz"/>
<SecondLD DomainName="org.nz"/>
<SecondLD DomainName="parliament.nz"/>
<SecondLD DomainName="school.nz"/>
</Allowed2LDs>
<Roles>
<Role RoleName="CancelDomain"/>
<Role RoleName="Connect"/>
<Role RoleName="CreateDomain"/>
<Role RoleName="Query"/>
<Role RoleName="Registrar"/>
<Role RoleName="TransferDomain"/>
<Role RoleName="UncancelDomain"/>
<Role RoleName="UpdateDomain"/>
<Role RoleName="UpdateRegistrar"/>
<Role RoleName="Whois"/>
</Roles>
<AuditDetails ActionId="2015-01-27-update-roles" RegistrarId="90">
<AuditTime>
<From Day="27" Hour="15" Minute="56" Month="01" Second="55" TimeZoneOffset="+13:00" Year="2015"/>
</AuditTime>
</AuditDetails>
</Registrar>
</Response>
</NZSRSResponse>