Skip to Main Content

Nominet

Log in to the online service
Log in to Online Services
Skip Primary Navigation
Skip All Secondary and Tertiary Navigation

Print this page  | Contact Us
The release operation allows a registrar to move a domain name, or account onto another tag.

The release operation is requested by enclosing an <r:release> element within an <update> command. The r prefix represents the std-release schema.

<r:release> element

The <r:release> element contains the following sub-elements:
  • Either an <r:domainName> element with the domain name to be released or an <r:registrant> element with the account to be released.
  • An <r:registrarTag> element with the tag to release the domain name to.

Example domain release request

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
  <command>
    <update>
      <r:release
        xmlns:r="http://www.nominet.org.uk/epp/xml/std-release-1.0"
        xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/std-release-1.0 std-release-1.0.xsd">
        <r:domainName>epp-example.co.uk</r:domainName>
        <r:registrarTag>EXAMPLE-TAG</r:registrarTag>
      </r:release>
    </update>
    <clTRID>ABC-12345</clTRID>
  </command>
</epp>

Example account release request

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
  <command>
    <update>
      <r:release
        xmlns:r="http://www.nominet.org.uk/epp/xml/std-release-1.0"
        xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/std-release-1.0 std-release-1.0.xsd">
        <r:registrant>S75TA03</r:registrant>
        <r:registrarTag>EXAMPLE-TAG</r:registrarTag>
      </r:release>
    </update>
    <clTRID>ABC-12345</clTRID>
  </command>
</epp>
Notes:
  1. If an account is released to another tag then all of its domain names are also released.
  2. If the receiving tag does not require a handshake then a response code of 1000 is returned to the client.
  3. If the receiving tag does require a handshake then a response code of 1001 is returned to the client to show that further action is necessary, an example is below.

Example response to a release request when a handshake is required by the receiving tag:

<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/epp-1.0 epp-1.0.xsd">
  <response>
    <result code="1001">
      <msg>Command completed successfully; action pending</msg>
    </result>
    <resData>
      <r:releasePending
        xmlns:r="http://www.nominet.org.uk/epp/xml/std-release-1.0"
        xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/std-release-1.0 std-release-1.0.xsd">
        Your request for a registrar change has resulted in a handshake
        request to the receiving tag. The receiving tag has up to 5 days to respond, after
        which the request will be expired. You will be notified of the success or
        failure of the registrar change.
      </r:releasePending>
    </resData>
    <trID>
      <clTRID>EPP-ABC-12345</clTRID>
      <svTRID>104239</svTRID>
    </trID>
  </response>
</epp>
 
 
 

© Nominet UK 1996-2012  |  Accessibility  |  Site Map  |  Feeds  |  Glossary  |  Privacy Policy  |  Terms of Use  |  Cookies  |  Contact Us