/v1/api/list/system/content/{listName} - BlueCat DNS Edge

DNS Edge API Guide

prodname
BlueCat DNS Edge

Returns the contents of the specified system-maintained domain lists in JSON or CSV format. You can leave out the Accept parameter to retrieve a CSV list instead of JSON.

For each domain, the last time the domain incurred DNS traffic identifying it as suspect for tunneling, and the time when that domain will be cleared from the list according to the system-level set TTL, are returned.

Request: GET https://api-<DNS.Edge.URL>/v1/api/list/system/content/tunneling
Authorization: Bearer token
Accept: application/JSON

Parameter

The only currently acceptable value for the listName is tunneling, which will return the content of the system-maintained tunneling quarantine list.

JSON Successful response

200 OK
Content-Type: application/JSON
[{
   "domain": "tunneling-domain.com",
   "lastObserved": "151069383",
   "expiryDate": 13470841344
},
{
   "domain": "bad-domain.com,"
   "lastObserved": "151069392"
   "expiryDate": 13470841344
}]

CSV Successful response

200 OK
Content-Type: text/plain

"2018-01-24T15:07Z,2018-07-23T15:07Z,abc.com\n2018-01-24T15:06Z,2018-07-23T15:06Z,go9e0r90e.com\n"

CSV field order: lastObserved,expiryDate,domain

Possible error codes
  • 500 Internal server error - ERROR_RETRIEVING_SYSTEMLIST_CONTENT: Failed to retrieve the system list content