Skip Navigation

Wblist endpoint

The wblist endpoint allows clients to get the latest restricted and allowed list of file hashes available.
Request
Item
Description
URL
GET /wblist
Parameters
after
(int, optional): Unix time stamp truncated to the second.
Examples
GET /wblist?after=1470700100
Headers
It is recommended that you pass the
Accept-Encoding: gzip
header in order to compress the result.
Response
A successful response returns status code 302. In the response header, the location field contains the URL the client is being redirected to and where the document containing the restricted and allowed list of file hashes is found. If the client requests a compressed, gzip version, the document is gzipped. The URL expires in 1 day.
If an error occurred, the service returns either 400 or 503. For any of these response codes, the body contains the following JSON documentation with a message field describing the error.
Allowed/Restricted endpoint response
{ "message" : "reason of failure" }
The JSON file has the following structure.
JSON data structure
{ "white": { "items": [ <sha256>, <sha256>, ... ] }, "black": { "items": [ <sha256>, <sha256>, ... ] } }