Object query operations can be used to to retrieve information about objects within our registry. We recommend that you read about our
object based data structure which will explain how querying these objects differs from the standard
domain queries. There are three different object query operations available:
- Account query
Account query is used to retrieve the information we store in the account object, such as 'opt-out' settings. This operation will also retrieve information about contact objects linked to the account object.
- Nameserver query
Nameserver query is used to retrieve information we store in the nameserver object, such as the hostname of a nameserver.
Account query
How to query an account object:
- Create a new email message to applications@nic.uk
- Use the subject TAG account Query (replace TAG with your tag name in capital letters).
- Copy the fields you require from the following template to your mail message:
operation: query
account-id:
Notes:
- It is mandatory to include values for all the fields in this template. For more information on template fields, see our field definitions.
- To query more than one account, you can repeat the 'account-id:' field separated by a blank line up to 100 times.
- PGP sign the message and send the email.
You will receive a
query response from the Automaton if the operation is successful.
You will receive an
error from the Automaton if the operation is unsuccessful. For help identifying and resolving an unsuccessful operation, see the
error messages page.
Nameserver query
How to query a nameserver object:
- Create a new email message to applications@nic.uk
- Use the subject TAG nameserver Query (replace TAG with your tag name in capital letters).
- Paste the following template into your email message:
operation: query
dns-name:
Notes:
- It is mandatory to include values for all the fields in this template. For more information on template fields, see our field definitions.
- To query more than one nameserver, you can repeat the 'dns-name:' field separated by a blank line up to 100 times.
- PGP sign the message and send the email.
You will receive a
query response from the Automaton if the operation is successful.
You will receive an
error from the Automaton if the operation is unsuccessful. For help identifying and resolving an unsuccessful operation, see the
error messages page.