API

Below you can find a few API calls that you can use to interact and communicate with dnsbl-webuitls.

Check a hostname/IP for blacklist entries

Request
/api/v1/check/[hostname]
Parameter
  • hostname: Hostname or IP of the mailserver to check
Response
        {
  "success": true,
  "information": {
    "execution_time": 4410,
    "dnsbls_total": 233,
    "dnsbls_ok": 229,
    "dnsbls_listed": 4,
    "hostname": "127.0.0.2"
  },
  "payload": [
    {
      "dnsbl": "access.redhawk.org",
      "result": "DNSBL: not listed",
      "status": 200
    },
    [...]
  ]
}

Probe a hostname against a specific DNSBL

Request
/api/v1/probe/[hostname]/[dnsbl]
Parameter
  • hostname: Hostname or IP of the mailserver to check
  • dnsbl: Hostname or IP of the DNSBL server
Response
        {
  "success": true,
  "payload": {
    "hostname": "127.0.0.2",
    "dnsbl": "access.redhawk.org",
    "result": "DNSBL: listed",
    "status": 300
  }
}