Overview of the SuppressionList API

The SuppressionList API allows you to programmatically create and remove lists, add entries to lists, remove entries from lists, or query Lists to see if they contains an entry.

Who Should Read This?

This is technical documentation. The target audience is those who intend to integrate another platform with SuppressionList. Everything a developer needs to integrate with SuppressionList is found in this documentation.

Please email if you find inconsistencies or need clarification. We want this documentation to be clear and easy to use and we're happy to get your feedback.

The Examples

This documentation contains an example for every API call. The examples use the ubiquitous curl command, which is widely available on *NIX systems and Mac OS X. If you only work on Microsoft platforms, then curl may not be familiar to you and you may therefore find the examples confusing. But don't despair, curl is also available for Windows, and is easy to learn. You can download curl here:

We recommend that you know how the curl command works before attempting to understand the examples. But even if you don't, it's still possible to decipher the examples. Here are the curl arguments you need to know:

  • -x: The HTTP method to use, i.e. -X POST to perform an HTTP POST
  • -h: Add a header, i.e. -H 'Content-Type: application/json' to set the request content type to "application/json"
  • -d: Set the HTTP request body, i.e. -d '{"name": "my_list"}' to put a JSON document in the request body
  • -u: Set the HTTP Basic Authentication credentials, i.e. -uAPI:12345 to use the "API" user with API key "12345"


Authentication is performed using Basic Authentication. This type of authentication is ubiquitous and secure when used over SSL. All requests to our API must be performed over SSL. The username portion of the Basic Authentication is ignored. The password must be your API key. Requests made without Basic Authentication will receive an HTTP 403 (Forbidden) response.

Next article:

Creating, cataloging and deleting lists.

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request


You must be logged in to comment.