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

DNS Edge API Guide

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


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


CSV field order: lastObserved,expiryDate,domain

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