Security & delivery
/api/v1/dns-blacklist-checkerPacketFlo DNS Blacklist Checker API
Check whether a host or IP is listed on major spam blocklists.
| Parameter | Type | Required | Description |
|---|---|---|---|
host | string | Yes | IPv4 address or domain (resolved to its first IPv4 address). |
Example request
curl "https://packetflo.io/api/v1/dns-blacklist-checker?host=1.1.1.1&api_key=YOUR_API_KEY"
Example response
{ "ok": true, "data": { "host": "1.1.1.1", "ip": "1.1.1.1", "resolvedFrom": null, "results": [ { "zone": "zen.spamhaus.org", "name": "Spamhaus ZEN", "status": "clean" }, { "zone": "bl.spamcop.net", "name": "SpamCop", "status": "clean" }, { "zone": "b.barracudacentral.org", "name": "Barracuda Reputation", "status": "clean" } // ... 3 more zones ], "listedCount": 0, "ipv6Only": false }, "meta": { "tool": "dns-blacklist-checker", "version": "v1" } }
Reading the result
Inspect each zone's listed, clean, error or timeout result. listedCount counts confirmed listings; zero does not prove every zone responded.
Response fields
| Field | What it tells you |
|---|---|
host / ip / resolvedFrom | Input and selected IPv4 address, with hostname-resolution context. |
results / listedCount | Per-zone outcomes and the number classified as listed. |
ipv6Only | True when no IPv4 address was available. In that case, an empty result was not tested and must not be treated as clean. |
Scope and limits
Checks six configured DNS blocklist zones in parallel with 2.5-second timeouts. Only IPv4 is checked. Spamhaus 127.255.255.x resolver and quota errors are reported as errors rather than listings.
Authentication and errors
Send your key in the x-api-key header, or the supported api_key query parameter. Each request uses 3 credits from the key's shared 300-credit rolling 24-hour budget. Credits are charged before parameter validation. Successful responses and quota errors include usage headers; GET and OPTIONS support CORS.
| API status | Meaning |
|---|---|
200 | The diagnostic returned a result in data, with ok: true and version information in meta. Read the diagnostic fields to determine the target's condition. |
400 | Invalid or blocked input, or a lookup/check failure that could not be returned as a diagnostic result. Read error for details. |
401 | Missing, invalid or revoked API key. |
429 | The request would exceed the key's available credit budget. |