Executing dig, host, and nslookup queries

 

⚠️
All queries must use the “APIKEY” from your account in app.abusix.com.

Query Basics

  • When querying for an IPv4 address, it must be in reverse order. e.g., to check if IP address 1.2.3.4 is present on a DNS list, the octets must be reversed, and you would query for 4.3.2.1.<list>.
  • For IPv6 addresses, these must be queried in reverse nibble format. e.g., to check if the IPv6 address 2001:db8::1 is present on a DNS list, you would query for “1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.<list>.”
  • For domains, these are appended to the query, e.g., to check if domain example.com is present, you would query for “example.com.<list>.

If a lookup returns an address in 127.0.0.0/8, then the entry is present on that list; if nothing is returned (NXDOMAIN), it is not on the list.

Examples:

To send a test query for an IP address to the test point, run one of the following commands:

# UNIX systems

$ dig +short 2.0.0.127.<APIKEY>.combined.mail.abusix.zone.
127.0.0.2

# or

$ host -t A 2.0.0.127.<APIKEY>.combined.mail.abusix.zone.
2.0.0.127.APIKEY.combined.mail.abusix.zone. has address 127.0.0.2
# Windows

> nslookup 2.0.0.127.<APIKEY>.combined.mail.abusix.zone.
Server:        1.1.1.1
Address:    1.1.1.1#53

Non-authoritative answer:
Name:    2.0.0.127.<APIKEY>.combined.mail.abusix.zone
Address: 127.0.0.2

Replace <APIKEY> with “Your API key” from your account in app.abusix.com.

If you do not receive “127.0.0.2”, then something is wrong. Check that your API key is entered correctly (it should be exactly 32 characters).

You may replace “combined” with any of the other Production Zones

Example:

To send a test query for a domain to the domain test point, run one of the following commands:

$ dig +short baddomain.org.<APIKEY>.dblack.mail.abusix.zone
127.0.1.2

$ dig +short okdomain.org.<APIKEY>.dblack.mail.abusix.zone
$

Replace <APIKEY> with “Your API key” from your account in app.abusix.com.

If you do not receive “127.0.0.2”, then something is wrong. Check that your API key is entered correctly (it should be exactly 32 characters).

Learn more about Guardian Mail

Send us a message

Having trouble with your set up or a technical issue? Get in touch with our team of Abusix experts.

Click the chat button at the bottom and send us your questions. Alternatively, you can email us at [email protected]

also, follow our LinkedIn Channel for updates & subscribe to our YouTube Channel for the latest Abusix how-to-videos.