The tag list command is used to obtain a list of all tags that accept tag changes
along with their handshake settings. It uses the
nom-tag-1.0 schema.
<tag:list> element
To obtain a list of tags, the <info> command must contain an empty <tag:list> element
<tag:listData> element
The <tag:listData> element returned in a response to a <tag:list> command
contains a <tag:infData> element for each tag.
Each <tag:infData> element contains the following child elements:
- A <tag:registrar-tag> element giving the tag.
- A <tag:name> element giving the company name for the tag
- An optional <tag:trad-name> element giving the trading name for the tag.
- A <tag:handshake> element giving the handshake setting for the tag. This is either 'Y' if the tag requires a handshake accepting domains onto its tag or 'N' if not.
Note that the list will contain more than 4000 <tag:infData> entries.
Examples
Example of a <tag:list> command
<?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>
<info>
<tag:list
xmlns:tag="http://www.nominet.org.uk/epp/xml/nom-tag-1.0"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-tag-1.0
nom-tag-1.0.xsd"/>
</info>
<clTRID>ABC-12345</clTRID>
</command>
</epp>
Example of a successful <tag:list> response
<?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">
<response>
<result code="1000">
<msg>Command completed successfully</msg>
</result>
<resData>
<tag:listData
xmlns:tag="http://www.nominet.org.uk/epp/xml/nom-tag-1.0"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-tag-1.0
nom-tag-1.0.xsd">
<tag:infData>
<tag:registrar-tag>EXAMPLE-TAG</tag:registrar-tag>
<tag:name>Example company name</tag:name>
<tag:trad-name>Example trading name</tag:trad-name>
<tag:handshake>Y</tag:handshake>
</tag:infData>
<tag:infData>
<tag:registrar-tag>EXAMPLE2-TAG</tag:registrar-tag>
<tag:name>Example2 company name</tag:name>
<tag:handshake>N</tag:handshake>
</tag:infData>
</tag:listData>
</resData>
</response>
</epp>