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:
- If an account is released to another tag then all of its domain names are also released.
- If the receiving tag does not require a handshake then a response code of 1000 is returned to the client.
- 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>