• You should not attempt to use the list operation for details on domain names that are not on your tag.   If you do so then this may be considered abuse of the Automaton.

• send to the address auto-list@nic.uk
• use a subject line of TAG List (replace TAG with the name of your tag in capital letters)
• specify the month of registration using one of the templates below
• make sure the e-mail is PGP signed

The Automaton will return a list containing all matching domain name registrations and all of the register fields for those domains.

This list operation returns all those domains on your tag registered within a particular month of a particular year. This template is in the following format:

operation: list
month: YYYY-MM

This list operation returns all those domains on your tag due to expire within a particular month of a particular year. This template is in the following format:

operation: list
expiry: YYYY-MM

This list operation returns all domains on your tag regardless of registration date.  This template is in the following format:

operation: list
month: all

This list operation returns all pre-Nominet domain names on your tag (domain names with no created date).  This template s in the following format:

operation: list
month: pre

Domain Name List follows...

Domain name|ips-key|created|first-bill|recur-bill|registrant|reg-contact|reg-trad-name
|reg-type|reg-co-no|reg-addr|reg-city|reg-county|reg-postcode|reg-country|reg-phone
|reg-fax|reg-email|reg-opt-out|reg-status|admin-c|a-addr|a-phone|a-fax|a-email|billing-c
|b-addr|b-phone|b-fax|b-email|dns0|dns1|dns2|dns3|dns4|dns5|dns6|dns7|dns8|dns9
|auto-bill|next-bill|changed|expiry

Number of domains in the list: [Number].

If you have any questions please contact support@nominet.org.uk.

Documentation on the automaton can be found on the Nominet UK Web site at http://www.nominet.org.uk/

1. There are no line breaks in the data fields in the actual reply.  These are only shown here for illustrative purposes.  In the actual message the data for each domain is on one line.  There is one line of data for each domain.
2. All dates are in the format CCYYMMDD.
3. [Number] is replaced with the correct number for the number of domains returned.
4. All new line characters are replaced with '^'.
5. The maximum outgoing message size the Automaton can send is limited to 250MB.  This equates to a list message of approximately 500,000 domains.
6. The definition for the fields can be found here.

After processing your operation the Automaton produces and sends an automated reply.  If there is a problem with the operation then two different error condition may occur

• non-fatal errors (warning messages) may be appended to successful replies.
• fatal errors that prevents the operation from being carried out and so an error reply is generated.