בס״ד

Email Blacklist Check

A blacklist check asks the major DNS-based blocklists whether an IP address is currently listed as a source of spam. Enter the IP address of a mail server, which is the usual case, or enter a domain and it is resolved to its addresses and each one is checked. Being listed is the most common reason outbound mail is rejected outright rather than filtered, and each list has its own delisting process, so the check tells you which one to go to.

Enter the IP address of a mail server, which is the usual case, or a domain. A domain is resolved to its IPv4 and IPv6 addresses and each one is checked.

$ curl https://api.dnsx.dev/email/blacklist/8.8.8.8 # same result as JSON

What is a DNSBL and how does the query work?

A DNS-based blocklist (DNSBL, also called an RBL after the original Realtime Blackhole List from 1997) is a list of IP addresses published as a DNS zone. Instead of downloading the whole list, a mail server asks the zone about one address at a time, using the same DNS query it would use for any hostname. That makes the check fast enough to run on every inbound connection before the server has read a single line of the message.

The query name is the IP address with its octets reversed, followed by the zone. To check 203.0.113.5 against Spamhaus ZEN, the mail server asks for an A record at 5.113.0.203.zen.spamhaus.org. The reversal mirrors the in-addr.arpa layout of reverse DNS, so that a whole network can be listed with one wildcard entry. If the name resolves, the address is listed, and the returned address (always in 127.0.0.0/8) says why: Spamhaus returns 127.0.0.2 for SBL, 127.0.0.4 for XBL and 127.0.0.10 or 11 for PBL. If the name does not exist (NXDOMAIN), the address is clean.

Our blacklist check sends that query to seven zones in parallel from our own resolver and reports the result, the return code and the response time for each. When you give it a domain, it resolves the domain to its IPv4 and IPv6 addresses (up to eight) and checks every one. IPv6 addresses are checked against the lists that publish IPv6 data, which today means Spamhaus ZEN.

How do I check a blacklist by hand?

Reverse the octets of the IP address, append the zone of the list and query the name with dig. An answer in 127.0.0.0/8 means the address is listed, and NXDOMAIN means it is clean. The example uses 8.8.8.8, which reads the same in both directions, so for 203.0.113.5 the name would be 5.113.0.203.zen.spamhaus.org. Repeat the query for each list you care about, or let the DNSX API run all of them at once.

dig 8.8.8.8.zen.spamhaus.org +short
dig 5.113.0.203.zen.spamhaus.org +short
dig 5.113.0.203.bl.spamcop.net +short

Which email blacklists matter most?

What matters is how many receiving servers consult a list. A listing on one nobody queries costs you nothing.

ListWhat it listsEffect on delivery
Spamhaus ZENA single zone combining SBL (known spam sources), XBL (compromised machines and open proxies), CSS (snowshoe spam) and PBL (ranges that should not send mail directly).Severe. Used by most mail servers worldwide, including through the filtering of many large providers.
SpamCopAddresses reported by SpamCop users, weighted by report volume, with automatic expiry after 24 hours without new reports.High. Widely used as a scoring signal and sometimes for outright rejection.
Barracuda (BRBL)Addresses seen sending spam to Barracuda's customer base and honeypots.High for the many organisations behind Barracuda appliances and cloud filtering.
PSBLAddresses that sent mail to spam traps, removed automatically once legitimate mail is seen.Moderate.
UCEPROTECT Level 1Individual addresses that hit its traps in the last seven days.Moderate.
UCEPROTECT Level 2 and 3Entire allocations (Level 2) or entire ASNs (Level 3) whose neighbours sent spam.Low. Most operators do not use them because they list innocent addresses by design.

Microsoft, Google and Yahoo do not publish their internal reputation systems as DNSBLs, so a clean result on every public list does not guarantee inbox placement. It does rule out the most common cause of hard bounces.

Why is my IP on UCEPROTECT Level 2 or 3 when I never sent spam?

Because those two levels list networks rather than addresses. Level 2 lists an entire allocation once a number of addresses inside it have hit UCEPROTECT's traps, and Level 3 lists a whole autonomous system once the proportion of listed addresses crosses a threshold. Your address is included because of what your neighbours did. Cloud provider ranges are on Level 3 more or less permanently.

You cannot delist yourself from Level 2 or 3, only the network owner can, and the listing expires on its own after seven days without new trap hits. UCEPROTECT offers immediate removal for a fee, which the wider anti-spam community treats as a reason to distrust the list, and few receivers act on these levels. If Level 1 is clean and Spamhaus is clean, a Level 2 or 3 listing is almost never the cause of a delivery problem.

How do I get delisted from an email blacklist?

  1. Find the cause. A listing almost always follows real spam from the address: a compromised account, a web form abused for relaying, malware on a machine behind the NAT, or a mailing list sending to addresses that no longer exist. Check the mail logs for the days before the listing and look for volume you did not expect.
  2. Stop it. Lists that see continued spam relist within hours, and repeated listings take longer to clear.
  3. Check the basics. Confirm the address has a PTR record that matches the mail server hostname, that SPF and DKIM pass, and that the server is not an open relay. Our SMTP test and reverse DNS lookup cover those.
  4. Request removal at the list. Each row in the result links to the operator's lookup page, which shows the reason for the listing and offers the removal form. Spamhaus explains the exact category and what it needs to see. SpamCop and PSBL expire automatically. Barracuda asks for a short form.
  5. Wait, then re-check. Removal takes anywhere from minutes to a day. Run the check again rather than assuming.

Does a Spamhaus PBL listing mean my server is sending spam?

No. The Policy Block List is a list of address ranges whose owners have said that no mail server should be sending directly from them: residential broadband, mobile networks, dynamic pools and similar. It is included in ZEN, so a query against ZEN returns a hit for these ranges, but the reason code is 127.0.0.10 or 127.0.0.11 rather than the SBL or XBL codes.

If you are running a mail server on a home or small business connection and see a PBL listing, the answer is to relay outbound mail through your ISP's SMTP server or a transactional mail provider, or to move the server to an address that is meant for it. If the address is a static one that your provider assigned for servers and it is still on the PBL, Spamhaus lets the address owner remove it through its website, after confirming the address is static and has a matching PTR record.

Frequently Asked Questions

What is an email blacklist?
An email blacklist, also called a DNSBL, RBL or blocklist, is a published list of IP addresses that have been seen sending spam or that belong to ranges where no mail server should be. Receiving mail servers query the list for every inbound connection and reject or score down mail from listed addresses. The DNSX blacklist check queries ten such lists, including Spamhaus ZEN, SpamCop, Barracuda and the three UCEPROTECT levels.
How does a DNSBL query work?
The sending IP address is reversed and prefixed to the blocklist zone as a DNS name. For 203.0.113.5 checked against zen.spamhaus.org, the query is for 5.113.0.203.zen.spamhaus.org. If the name resolves to an address in 127.0.0.0/8, the IP is listed, and the exact address encodes the reason. If the name does not exist, the IP is not listed. The DNSX blacklist check sends that query to each list in parallel and reports which ones answered.
Which email blacklists matter most?
Spamhaus ZEN is used by the majority of mail servers worldwide and a listing there stops mail almost everywhere. SpamCop and Barracuda are the next most widely consulted. Listings on SORBS, PSBL or UCEPROTECT Level 1 affect a smaller share of receivers. UCEPROTECT Levels 2 and 3 list entire networks and are ignored by most operators, so a listing there rarely causes delivery problems on its own.
How do I get delisted from an email blacklist?
Fix the cause first, because most lists relist within hours if spam continues. Then go to the list operator's own lookup page, which the DNSX blacklist check links from every row. Spamhaus, SpamCop and Barracuda offer self-service removal once the address stops sending spam. UCEPROTECT expires listings automatically after seven days without new spam, or sooner for a fee, which most operators advise against paying. There is no central place to delist from every blocklist at once.
What does a Spamhaus PBL listing mean?
The Spamhaus Policy Block List (PBL) lists IP ranges that the ISP or the address owner has declared should not be sending mail directly, such as residential broadband and dynamic pools. It is not an accusation of spamming. A PBL listing is expected for a home connection and means you should send through your provider's SMTP relay or an authenticated submission server on port 587 instead of directly on port 25.
Can a domain be blacklisted, and how is that different from an IP?
Yes. Domain blocklists such as Spamhaus DBL and SURBL list domain names that appear in spam, whether as the sender or as a link in the body. The DNSX blacklist check resolves a domain to its IPv4 and IPv6 addresses and checks each one against the IP-based lists, which answers whether the servers behind the domain are listed. It does not query domain-based lists.

Related tools