Who it is for
Use bounded passive checks to enrich triage and investigation, not to replace authorized testing or human review.
Try a product, outcome, endpoint path, or API topic.
Check if a domain or IP is listed on email blacklists.
Check if a domain or IP is listed on email blacklists.
Use bounded passive checks to enrich triage and investigation, not to replace authorized testing or human review.
Choose this to check supported blacklist evidence at a point in time. A clean result is not a universal reputation guarantee.
Check if a domain or IP is listed on email blacklists.
See what each endpoint accepts and returns, its modes and its limits before you integrate.
0-1 Authentication required. See the API reference for the exact cost, including any per-item pricing.
Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.
| Parameter | Type | required |
|---|---|---|
| string | required | |
| checks | string | optional |
| Field | Type |
|---|---|
email |
string |
domain |
string |
local_part |
string |
valid_syntax |
boolean |
checks |
object |
checks.disposable |
object |
checks.disposable.is_disposable |
boolean |
checks.disposable.confidence |
string | null |
checks.disposable.matched_pattern |
string |
checks.role |
object |
checks.role.is_role |
boolean |
checks.role.role_type |
string | null |
checks.free |
object |
checks.free.is_free |
boolean |
checks.free.provider |
string | null |
checks.mx |
object |
checks.mx.has_mx |
boolean | null |
checks.mx.records[] |
string[] |
checks.mx.null_mx |
boolean |
checks.dnsbl |
object |
checks.dnsbl.domain |
string |
checks.dnsbl.ip |
string |
checks.dnsbl.listed |
boolean |
checks.dnsbl.lists[] |
object[] |
checks.dnsbl.lists[] |
object |
checks.dnsbl.lists[].name |
string |
checks.dnsbl.lists[].listed |
boolean |
checks.dnsbl.lists[].status |
string |
checks.dnsbl.lists[].code |
string |
checks.dnsbl.lists[].meaning |
string |
checks.dnsbl.lists[].unknown_reason |
string |
checks.dnsbl.lists_unknown |
integer |
checks.dnsbl.threat_level |
string |
checks.dnsbl.check_type |
string |
checks.dnsbl.checked_at |
string |
risk_score |
integer |
risk_level |
string |
flags[] |
string[] |
checked_at |
string |
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl"const response = await fetch("https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body)){
"email": "[email protected]",
"domain": "acme-widgets.com",
"local_part": "support",
"valid_syntax": true,
"checks": {
"disposable": {
"is_disposable": false,
"confidence": null
},
"role": {
"is_role": true,
"role_type": "support"
},
"free": {
"is_free": false,
"provider": null
},
"mx": {
"has_mx": true,
"records": [
"mx1.mailhost-example.net",
"mx2.mailhost-example.net"
]
},
"dnsbl": {
"listed": false,
"threat_level": "none"
}
},
"risk_score": 20,
"risk_level": "low",
"flags": [
"ROLE_ADDRESS"
],
"checked_at": "2026-10-09T10:15:30.000Z"
}
200 OK400 Bad Request401 Unauthorized402 Payment Required429 Too Many RequestsUse the API reference for Email Blacklist to review parameters, response fields, examples, status codes, and supported operation modes.
Unknown or partial means we could not fully confirm the result. Keep the status, confidence, freshness and any limits in mind when you act on it.
The price depends on the check and the mode you choose. The API reference shows the current credit cost, whether you need an API key, and any per-item pricing.
Used by people at these companies