/v1/api/list/system/content/{listName} (GET) - BlueCat Edge - Service Point v3.x.x

BlueCat Edge User Guide

Locale
English
Product name
BlueCat Edge
Version
Service Point v3.x.x

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-<BlueCat.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
  • UNAUTHORIZED - Missing or invalid token
  • INTERNAL SERVER ERROR