Dataset Download

This API endpoint allows the download of an entire current dataset, in compressed format. Access to this API endpoint is only granted to customers who have subscribed for enterprise access to that specific dataset.

The query URL is:

  • GET /api/intel/v1/download/ext/<DATASET>

Arguments list:

  • DATASET - identifies the dataset to download. Currently supported dataset values are: bcl, xbl, css

Usage example:

# get eBCL full dataset export file
wget --header="Authorization: Bearer <AUTH TOKEN>" \
   --output-document=bcl.tgz \
   https://api.spamhaus.org/api/intel/v1/download/ext/bcl

This API will return binary data. The output is a compressed file with tar and gzip (.tgz extension).

Return Codes

The dataset download API will return the following HTTP codes:

  • 200 - Download OK

  • 401 - User not allowed to access the functionality

  • 404 - Specified dataset file not found