Skip to Main Content

Nominet

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

Print this page  | Contact Us
The Query operation is used to obtain a list of fields for any domain name, account, nameserver or contact on your tag. 

Guidelines
  • Queries on domain names or other objects not on your tag will be rejected.
  • 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
  • To query a domain name use a subject line of TAG Domain Query or TAG Query (replace TAG with your tag name in capital letters) and use the template below to specify a domain name.
  • To query an account, use a subject line of TAG Account Query and use the account template below to specify an account.
  • To query a nameserver, use a subject line of TAG Nameserver Query and use the nameserver template below to specify a nameserver
  • To query a contact, use a subject line of TAG Contact Query and use the contact template below to specify a contact.
  • Up to 100 domain names, accounts, nameservers or contacts can be specified in one message by separating each set of fields with a blank line. The message may contain queries of only one object type.
  • Make sure the email is PGP-signed with a registered PGP key .

Operation template

Domain query
The following template is used:
operation: query
key:
Account query
operation: query
account-id:
Nameserver query
operation: query
dns-id:
Contact query
operation: query
contact-id:

Reply template

A separate reply is sent for each domain name, account, nameserver or contact even if they were all sent in one email.

Domain Query Replies

There are two formats this reply can take, to allow for backwards compatibility. With the field USE_NEW_AUTOMATON_FIELDS set to 'Y' (see the options for further details):

Subject: Re: TAG Query

The following message was sent from the Automaton:

*key:
*reg-status:
*dns-id:
*dns:
*dns-id:
*dns:
*registrar-tag:
*account-id:
*account-name:
*type:
*co-no:
*trad-name:
*opt-out:
*a1-id:
*a1-name:
*a1-email:
*a1-phone:
*a1-fax:
*a1-mobile:
*a2-id:
*a2-name:
*a2-email:
*a2-phone:
*a2-fax:
*a2-mobile:
*a3-id:
*a3-name:
*a3-email:
*a3-phone:
*a3-fax:
*a3-mobile:
*b1-id:
*b1-name:
*b1-email:
*b1-phone:
*b1-fax:
*b1-mobile:
*b2-id:
*b2-name:
*b2-email:
*b2-phone:
*b2-fax:
*b2-mobile:
*b3-id:
*b3-name:
*b3-email:
*b3-phone:
*b3-fax:
*b3-mobile:
*addr:
*addr:
*locality:
*city:
*county:
*postcode:
*country:
*b-addr:
*b-addr:
*b-locality:
*b-city:
*b-county:
*b-postcode:
*b-country:
*next_bill:
*auto_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 Web
site at http://www.nominet.org.uk/go/automaton

 
With the field USE_NEW_AUTOMATON_FIELDS set to 'N' (the default behaviour):

Subject: Re: TAG Query

The following message was sent from the Automaton:

*key:
*reg-status:
*dns0-id:
*dns0:
*dns1-id:
*dns1:
*ips-key:
*account-id:
*for:
*reg-type:
*reg-co-no:
*reg-trad-name:
*reg-opt-out:
*reg-contact-id:
*reg-name:
*reg-email:
*reg-phone:
*reg-fax:
*reg-mobile:
*a2-contact-id:
*a2-name:
*a2-email:
*a2-phone:
*a2-fax:
*a2-mobile:
*a3-contact-id:
*a3-name:
*a3-email:
*a3-phone:
*a3-fax:
*a3-mobile:
*b-contact-id:
*b-name:
*b-email:
*b-phone:
*b-fax:
*b-mobile:
*b2-contact-id:
*b2-name:
*b2-email:
*b2-phone:
*b2-fax:
*b2-mobile:
*b3-contact-id:
*b3-name:
*b3-email:
*b3-phone:
*b3-fax:
*b3-mobile:
*reg-addr:
*reg-addr:
*reg-locality:
*reg-city:
*reg-county:
*reg-postcode:
*reg-country:
*b-addr:
*b-addr:
*b-locality:
*b-city:
*b-county:
*b-postcode:
*b-country:
*next_bill:
*auto_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 Web
site at http://www.nominet.org.uk/go/automaton
Notes
  1. The TAG in the subject lines is replaced with your TAG, provided that you specified it in the original subject.
  2. Blank fields are not included, they are all shown here for illustrative purposes.
  3. In the new Automaton, dns entries are not stored in a particular order, so the fields shown for backwards compatibility may not be ordered dns0, dns1 etc.
Account Query Replies

As with the domain query replies, there are two formats to allow for backwards compatibility. With the field USE_NEW_AUTOMATON_FIELDS set to 'Y':

Subject: Re: TAG Account Query

The following message was sent from the Automaton:

*account-id:
*account-name:
*type:
*co-no:
*trad-name:
*opt-out:
*a1-id:
*a1-name:
*a1-email:
*a1-phone:
*a1-fax:
*a1-mobile:
*a2-id:
*a2-name:
*a2-email:
*a2-phone:
*a2-fax:
*a2-mobile:
*a3-id:
*a3-name:
*a3-email:
*a3-phone:
*a3-fax:
*a3-mobile:
*b1-id:
*b1-name:
*b1-email:
*b1-phone:
*b1-fax:
*b1-mobile:
*b2-id:
*b2-name:
*b2-email:
*b2-phone:
*b2-fax:
*b2-mobile:
*b3-id:
*b3-name:
*b3-email:
*b3-phone:
*b3-fax:
*b3-mobile:
*addr:
*addr:
*locality:
*city:
*county:
*postcode:
*country:
*b-addr:
*b-addr:
*b-locality:
*b-city:
*b-county:
*b-postcode:
*b-country:
*created:
*changed:

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

Documentation on the automaton can be found on the Nominet Web
site at http://www.nominet.org.uk/go/automaton
With the field USE_NEW_AUTOMATON_FIELDS set to 'N' (the default behaviour):
Subject: Re: TAG Account Query

The following message was sent from the Automaton:

*account-id:
*for:
*reg-type:
*reg-co-no:
*reg-trad-name:
*reg-opt-out:
*reg-contact-id:
*reg-name:
*reg-email:
*reg-phone:
*reg-fax:
*reg-mobile:
*a2-contact-id:
*a2-name:
*a2-email:
*a2-phone:
*a2-fax:
*a2-mobile:
*a3-contact-id:
*a3-name:
*a3-email:
*a3-phone:
*a3-fax:
*a3-mobile:
*b-contact-id:
*b-name:
*b-email:
*b-phone:
*b-fax:
*b-mobile:
*b2-contact-id:
*b2-name:
*b2-email:
*b2-phone:
*b2-fax:
*b2-mobile:
*b3-contact-id:
*b3-name:
*b3-email:
*b3-phone:
*b3-fax:
*b3-mobile:
*reg-addr:
*reg-addr:
*reg-locality:
*reg-city:
*reg-county:
*reg-postcode:
*reg-country:
*b-addr:
*b-addr:
*b-locality:
*b-city:
*b-county:
*b-postcode:
*b-country:
*created:
*changed:

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

Documentation on the automaton can be found on the Nominet Web
site at http://www.nominet.org.uk/go/automaton
Nameserver query replies
Subject: Re: TAG Nameserver Query

The following message was sent from the Automaton:

*dns-id:
*dns:
*created:
*changed:

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

Documentation on the automaton can be found on the Nominet Web
site at http://www.nominet.org.uk/go/automaton
Contact reply
Subject: Re: TAG Contact Query

The following message was sent from the Automaton:

*contact-id:
*name:
*email:
*phone:
*fax:
*mobile:
*changed:

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

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

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.
 
 
 

© Nominet UK 1996-2008  |  Accessibility  |  Site Map  |  Feeds