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  
  1. If no administrative contact details are provided the Registrant details are used as administrative contact details as well.
  2. 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.

Registering a new domain name:

<NZSRSRequest RegistrarId="90" VerMajor="5" VerMinor="0">
    <DomainCreate ActionId="Unique Value 1234" Delegate="1" DomainName="nzrstest.co.nz" Term="12">
        <RegistrantContact Email="test@nzrstest.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@nzrstest.co.nz" Name="Admin Manager, NZRS Ltd">
            <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@nzrstest.co.nz" Name="Technical Manager, NZRS Ltd">
            <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.nzrstest.co.nz" IP4Addr="8.8.8.8"/>
            <Server FQDN="ns2.nzrstest.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="nzrstest.co.nz" RegistrarId="90" Status="Active" Term="1" UDAI="SvmTxPXw">
            <NameServers>
                <Server FQDN="ns1.nzrstest.co.nz" IP4Addr="8.8.8.8"/>
                <Server FQDN="ns2.nzrstest.co.nz" IP4Addr="8.8.4.4"/>
            </NameServers>
            <RegistrantContact Email="test@nzrstest.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@nzrstest.co.nz" Name="Admin Manager, NZRS Ltd">
                <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@nzrstest.co.nz" Name="Technical Manager, NZRS Ltd">
                <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@nzrstest.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@nzrstest.co.nz" Name="Admin Manager, NZRS Ltd">
            <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@nzrstest.co.nz" Name="Technical Manager, NZRS Ltd">
            <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@nzrstest.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@nzrstest.co.nz" Name="Admin Manager, NZRS Ltd">
        <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@nzrstest.co.nz" Name="Technical Manager, NZRS Ltd">
        <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 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="nzrshandles.net.nz" Term="12">
        <RegistrantContact HandleId="nzrs0001"/>
        <AdminContact HandleId="nzrs0001"/>
        <TechnicalContact HandleId="nzrs0001"/>
        <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="nzrshandles.net.nz" RegistrarId="60" Status="Active" Term="1" UDAI="k3yqkXP2">
      <RegistrantContact ActionId="srs-1_21403" Email="support@nzrs.net.nz" HandleId="nzrs0001" Name="NZRS Ltd">
        <PostalAddress Address1="NZRS Ltd" 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="support@nzrs.net.nz" HandleId="nzrs0001" Name="NZRS Ltd">
        <PostalAddress Address1="NZRS Ltd" 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="support@nzrs.net.nz" HandleId="nzrs0001" Name="NZRS Ltd">
        <PostalAddress Address1="NZRS Ltd" 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@nzrstest.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@nzrstest.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@nzrstest.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.

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
  • To renew a domain name immediately
  • Boolean value "0" or "1"
  • Required Term value
NewUDAI no
  • to request a new UDAI
  • boolean value "0" or "1"
Cancel no
  • to change the status of domain name to Active or PendingRelease
  • boolean value
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  
  1. If the administrative contact details are deleted (eg <AdminContact/> attribute with no elements) the Registrant details are used as administrative contact details as well.
  2. If the technical contact details are deleted (eg <TechnicalContact/> attribute with no elements) the Registrar's technical contact details are used.

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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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>nzrs-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="nzrs-change-delegate-status.co.nz" RegistrantRef="ref" RegistrarId="90" Status="Active" Term="12">
            <RegistrantContact Email="test@nzrstest.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@nzrstest.co.nz" Name="Admin Manager, NZRS Ltd">
                <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@nzrstest.co.nz" Name="Technical Manager, NZRS Ltd">
                <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>nzrs-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="nzrs-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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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>nzrs-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="nzrs-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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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="support@nzrs.net.nz" HandleId="nzrs0001" 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>nzrs-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="nzrs-sample-transfer.co.nz" RegistrarId="90" Term="1">
            <RegistrantContact Email="support@nzrs.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="support@nzrs.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="support@nzrs.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>nzrs-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="nzrs-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="nzrs-update-everything-domain.co.nz" RegistrantRef="ref" RegistrarId="90" Status="Active" Term="12">
      <NameServers>
        <Server FQDN="test.co.nz"/>
        <Server FQDN="nzrs-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 nzrs0001 handles to nzrshandles.nz">
    <DomainNameFilter>nzrshandles.nz</DomainNameFilter>
    <RegistrantContact HandleId="nzrs0001"/>
    <AdminContact HandleId="nzrs0001"/>
    <TechnicalContact HandleId="nzrs0001"/>
    <AuditText>update domain to use nzrs0001 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 nzrs0001 handles to nzrshandles.nz">
    <FeTimeStamp Day="22" Hour="09" Minute="17" Month="07" Second="23" TimeZoneOffset="+12:00" Year="2015"/>
    <Domain Delegate="1" DomainName="nzrshandles.nz" RegistrarId="60" Status="Active" Term="1">
      <RegistrantContact ActionId="srs-1_21403" Email="support@nzrs.net.nz" HandleId="nzrs0001" Name="NZRS Ltd">
        <PostalAddress Address1="NZRS Ltd" 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="support@nzrs.net.nz" HandleId="nzrs0001" Name="NZRS Ltd">
        <PostalAddress Address1="NZRS Ltd" 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="support@nzrs.net.nz" HandleId="nzrs0001" Name="NZRS Ltd">
        <PostalAddress Address1="NZRS Ltd" 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 nzrs0001 handles to nzrshandles.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 nzrs0001 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@nzrstest.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@nzrstest.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>

Update a domains nameservers and glue records

<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
  <DomainUpdate ActionId="Change Name Servers an IP address">
    <DomainNameFilter>nzrs-sample-nameserver.co.nz</DomainNameFilter>
    <NameServers>
      <Server FQDN="ns1.nzrs-sample-nameserver.co.nz" IP4Addr="202.121.22.22"/>
      <Server FQDN="ns2.nzrs-sample-nameserver.co.nz" IP4Addr="202.212.36.25"/>
      <Server FQDN="ns3.nzrs-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="nzrs-sample-nameserver.co.nz" RegistrarId="90" Status="Active" Term="1">
      <NameServers>
        <Server FQDN="ns1.nzrs-sample-nameserver.co.nz" IP4Addr="202.121.22.22"/>
        <Server FQDN="ns2.nzrs-sample-nameserver.co.nz" IP4Addr="202.212.36.25"/>
        <Server FQDN="ns3.nzrs-sample-nameserver.co.nz" IP4Addr="202.131.45.23"/>
      </NameServers>
      <RegistrantContact Email="test@nzrstest.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@nzrstest.co.nz" Name="Admin Manager, NZRS Ltd">
        <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@nzrstest.co.nz" Name="Technical Manager, NZRS Ltd">
        <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 registrar. When a registrar tries to retrieve historical information from period that the domain name was not registered with them then no results are returned.

To view history for a domain you can include the ShowHistory="1" attribute, which will return all historic data for the domain(s) in question during the most recent period the domain was under the control of your registrar.

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="NZRS Test Registrar 945" Status="Active" Term="1">
      <NameServers>
        <Server FQDN="ns.co.nz"/>
        <Server FQDN="ns2.co.nz"/>
      </NameServers>
      <RegistrantContact Email="test@nzrs-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@nzrs-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@nzrs-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="NZRS Test Registrar 945" Status="Active" Term="1">
      <NameServers>
        <Server FQDN="ns.co.nz"/>
        <Server FQDN="ns2.co.nz"/>
      </NameServers>
      <RegistrantContact Email="test@nzrs-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@nzrs-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@nzrs-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 request to check availability:

<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
    <Whois DomainName="nzrs.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="nzrs.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="nzrs.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="nzrs.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="support@nzrs.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="support@nzrs.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="support@nzrs.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 perform multiple availability checks:

<NZSRSRequest RegistrarId="90" VerMajor="3" VerMinor="0">
    <Whois DomainName="nzrs.co.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.net.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.org.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.ac.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.cri.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.gen.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.govt.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.iwi.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.mil.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.school.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.maori.nz" FullResult="0" SourceIP="1.2.3.4"/>
    <Whois DomainName="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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="nzrs.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, new UDAI) .

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="4j4PGGBy">
        <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="8AnJGc9Y">
        <NameServers>
          <Server FQDN="ns1.nameserva.co.nz"/>
          <Server FQDN="ns2.nameserva.co.nz"/>
        </NameServers>
        <RegistrantContact Email="test@nzrs-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@nzrs-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@nzrs-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="NZRS 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="NZRS 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%228AnJGc9Y%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
Email yes
<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@nzrs-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@nzrs-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>

HandleUpdate

HandleUpdate allows registrars to update existing handles.

Updating a name can potentially update the registrant of one or more domain names if a handle is linked with the RegistrantContact of one or more domains. If that is the case the update is treated as registrant update and new UDAIs will be generated for the affected domain names. The HandleUpdate response will contain an element Domain that lists all domain names that are effected by the update. The new UDAIs are returned in a DomainUpdate message supplied in the registrar's GetMessage queue. Registrars can also generate new UDAIs by sending a DomainUpdate transaction.

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 will create new UDAIs for all updated domain names which are returned in the actual DomainUpdate response. 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  
Email yes  
<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 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>

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 support@nzrs.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@nzrs-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@nzrs-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@nzrs-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@nzrs-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@nzrs-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@nzrs-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>