The CBL API allows developers and community managers to spot known bad actors by including a global blacklist.

Using the API


This API is still under HEAVY development. Breaking changes may happen with little to no warning.

All API request use the base URL{version}/

API version Status
v1 Pre-release

All 3rd-party applications using the API should set a user agent that identifies their application.
Example: User-Agent: Pi (, v1.0)


Some requests require authentication. To authenticate with the API you must be an admin of the bot dev team.

API tokens should be sent in the Authorization header of requests.

Last Updated: 1/29/2019, 4:12:46 PM