Endpoint
Description
Get information about listed ip-addresses. A POST request is required for this to work (officially). However, one (unsupported) command does the same: /3.0/dnsbl/request/ip/<address>
Parameters
| Parameter | Description |
|---|---|
| ip | Address list (arrays allowed) |
Examples
Request
{"ip":["44.11.12.77","18.33.14.30"]}
Response
"dnsblResponse": [
{
"ip": "44.11.12.77",
"typebit": "84",
"discovered": "2017-12-16 16:06:03",
"typestring": "torexit",
"deleted": "2018-06-30 05:00:18",
"lastchange": "2018-06-30 05:00:18"
},
{
"ip": "18.33.14.30",
"typebit": "84",
"discovered": "2017-11-03 20:53:54",
"typestring": "phishing",
"deleted": "0000-00-00 00:00:00",
"lastchange": "2017-11-03 20:53:54"
}
]
As you can see, one of the hosts above are also marked as deleted by the deleted-string. This means that is has been removed from the DNS service and therefore won't shop up in a DNS request. This kind of flags is used to show - in removal tools - that the host has been listed but is now removed.
When the API find no blacklisted hosts
As of APIv3, exceptions are thrown in the response interface if nothing is found as listed. This should make it easier to detect errors together with unlisted addresses, instead of looking for empty response arrays. This is what's thrown, when this occurs.
Exceptions in API
{
"response": [],
"errors": {
"code": "404",
"success": "",
"faultstring": "Nothing found as listed"
}
}