Security & delivery

GET/api/v1/dns-blacklist-checker

PacketFlo DNS Blacklist Checker API

Cost: 3 credits per request

Check whether a host or IP is listed on major spam blocklists.

ParameterTypeRequiredDescription
hoststringYesIPv4 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

FieldWhat it tells you
host / ip / resolvedFromInput and selected IPv4 address, with hostname-resolution context.
results / listedCountPer-zone outcomes and the number classified as listed.
ipv6OnlyTrue 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 statusMeaning
200The diagnostic returned a result in data, with ok: true and version information in meta. Read the diagnostic fields to determine the target's condition.
400Invalid or blocked input, or a lookup/check failure that could not be returned as a diagnostic result. Read error for details.
401Missing, invalid or revoked API key.
429The request would exceed the key's available credit budget.
SPF Checker