API Guide

Select Blacklists

Select Blacklists allows customers to update the list of blacklists they wish to monitor in an existing profile. This endpoint does not have a PUT method and will replace old blacklist selections with the new POST. Data is returned in the following formats: XML, JSON, CSV and Serialized.

Required headers: X-API-KEY
Optional headers: ACCEPT (json, xml, csv, serialized)
Method: POST

Endpoint URL:


Sample Output:

    "status": "success"


Parameter Description Acceptable Values Required
profile_id The unique identifier of the monitor summary. NOTE: Profile IDs can be retrieved by executing the Profile Summary API call. Integer Y
blacklist_keys A comma-separated list of blacklist keys to monitor. Example: "14,44" for Barracuda BRBL and CASA CBL. Note: Blacklist keys can be retrived from Get Blacklists. You can retrieve the existing set of monitored blacklist keys using the Profile Summary API. String Y

Error Responses

Description Code Cause
Invalid profile ID. 404 The unique identifier of the profile is empty or invalid.
Invalid blacklist keys. 404 Please provide a comma-separated list of blacklist keys. See Get Blacklists.
Invalid blacklist keys format. 404 Please provide a comma-separated list of blacklist keys.
Blacklist keys must be numeric. 404 Non-numeric blacklist keys were detected.
No results found. 403 Forbidden / We couldn't find any results matching your criteria.