QUERY operation
The Query operation is used to obtain a list of fields for any domain name on the register.
Guidelines
-
You can perform a Query on a domain name that is not on your tag and usable information will be returned. However this will count towards the limit set for abuse detection. Full details of the limits and how they affect you are given in our
acceptable use policy.
-
If you want information of more than one domain then you should look at the
LIST operation or the
BULK operation.
Instructions
-
Send to the appropriate address (see below for details)
-
use a subject line of TAG Query (replace TAG with your tag name in capital letters)
-
use the template below to specify the domain name you wish to query
-
you can specify up to 100 domain names in one message by separating each set of fields with a blank line
-
make sure the e-mail is PGP-signed with a
registered PGP key.
Which address to use
The appropriate address will correspond to the Second level Domain within which the domain name is registered. Appropriate addresses are as follows:
- .co.uk -> auto-co@nic.uk
- .me.uk -> auto-me@nic.uk
- .org.uk -> auto-org@nic.uk
- .net.uk -> auto-net@nic.uk
- .ltd.uk -> auto-ltd@nic.uk
- .plc.uk -> auto-plc@nic.uk
- .sch.uk -> auto-sch@nic.uk
Operation template
The following template is used:
operation: query
key:
Reply template
A separate reply is sent for each domain name even if they were all sent in one operation. The reply template is different, depending on whether the domain name is on your tag or not.
If the domain is on your tag then the following template is used
Subject: Re: TAG Query
The following message was sent from the Automaton:
*key:
*for:
*ips-key:
*dns0:
*dns1:
*dns2:
*dns3:
*dns4:
*dns5:
*dns6:
*dns7:
*dns8:
*dns9:
*reg-contact:
*reg-trad-name:
*reg-type:
*reg-co-no:
*reg-opt-out:
*reg-addr:
*reg-city:
*reg-county:
*reg-country:
*reg-postcode:
*reg-phone:
*reg-fax:
*reg-email:
*admin-c:
*a-phone:
*a-fax:
*a-email:
*a-addr:
*billing-c:
*b-phone:
*b-fax:
*b-email:
*b-addr:
*first-bill:
*recur-bill:
*auto-bill:
*next-bill:
*notes:
*created:
*changed:
*expiry:
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/
Notes
- The TAG in the subject lines is replaced with your TAG, provided that you specified it in the original subject.
- Blank fields are not included, they are all shown here for illustrative purposes.
If the domain name is not on your tag then the following reply template is used
Subject: Re: TAG Query
The following message was sent from the Automaton:
*key:
*for:
*ips-key:
*dns0:
*dns1:
*dns2:
*dns3:
*dns4:
*dns5:
*dns6:
*dns7:
*dns8:
*dns9:
If you have any questions please contact nominet@nominet.org.uk.
Documentation on the automaton can be found on the Nominet UK Web
site at http://www.nominet.org.uk/
Errors
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.
Full details of the template of the error reply and the meaning of the error messages can be found
here.