CAKE API — Suppression & Compliance

Jeff Olliver

Modified on: Fri, 19 Jun, 2026 at 8:09 PM

This article will cover the following:

Get Suppression Lists
Attach Suppression List to Offer
Get Optizmo Suppression Files

Why use this API?
Use the Suppression & Compliance API to manage email suppression lists, integrate with Optizmo or other suppression providers, and enforce CAN-SPAM/CASL compliance rules across your affiliate network's email-driven offers.

Authentication: All CAKE API requests require your api_key parameter. Find yours under Setup → System Access → API Keys.

Overview

CAKE's suppression and compliance tools allow network operators to enforce list-level restrictions on email-driven affiliate campaigns. Suppression lists contain email addresses or domains that must not be mailed — typically because the recipient has unsubscribed, complained, or been flagged for compliance reasons.

CAKE integrates natively with Optizmo, one of the industry's leading suppression list management platforms, allowing affiliates to download suppression files directly from the affiliate portal before mailing. Network administrators control which suppression lists are attached to which offers, and can require list downloads as a condition of campaign participation.

Suppression management is handled in the CAKE UI under Offers → Manage Offers → [Offer] → Suppression Lists. The API exposes endpoints for listing, attaching, and removing suppression lists from offers programmatically.

Key Concepts

Suppression List — A file containing email addresses or domains that affiliates must exclude before sending email traffic to an offer. Lists may be network-managed or sourced from a third-party provider like Optizmo.
Optizmo Integration — CAKE's native integration with the Optizmo suppression list platform. When configured, affiliates can download their required suppression files directly from the CAKE affiliate portal before each mailing.
Suppression List Status — Controls whether a suppression list is active and enforced on an offer. Statuses include active and inactive.
CAN-SPAM — The US federal law governing commercial email. Requires honoring unsubscribe requests within 10 business days and maintaining suppression compliance. CAKE's suppression tools support CAN-SPAM workflows.
CASL — Canada's Anti-Spam Legislation. Requires express consent for commercial emails sent to Canadian recipients. Suppression list enforcement helps networks document compliance.
Opt-Out — A recipient's request to stop receiving commercial emails from a sender. Opt-out email addresses must be added to suppression lists and honored by all affiliates running email offers.

Available Actions

Get Suppression Lists

When to use: Retrieve all suppression lists configured in your CAKE network — use when auditing compliance assets, building a suppression management dashboard, or confirming which lists are attached to a given offer.

GET/api/2/suppression_lists.json

Parameter	Type	Required	Description
api_key	string	Yes	Your CAKE API key.
suppression_list_id	integer	No	Filter to a single suppression list by its CAKE ID.
suppression_list_status	string	No	Filter by status: `active`, `inactive`.

Sample request

GET https://yourdomain.cakemarketing.com/api/2/suppression_lists.json?api_key=YOUR_API_KEY&suppression_list_status=active

Sample response

{
  "request_status": "Success",
  "response": {
    "suppression_lists": [
      {
        "suppression_list_id": 5,
        "suppression_list_name": "Network Master Suppression",
        "suppression_list_status": "active",
        "record_count": 142893,
        "last_updated": "2026-06-01T08:00:00Z",
        "source": "optizmo"
      }
    ],
    "total_rows": 1
  }
}

Attach Suppression List to Offer

When to use: Associate a suppression list with an offer so affiliates are required to download and honor it before mailing — use when onboarding new email offers or adding compliance requirements to existing campaigns.

POST/api/2/offer_suppression_list.json

Parameter	Type	Required	Description
api_key	string	Yes	Your CAKE API key.
offer_id	integer	Yes	The offer to attach the suppression list to.
suppression_list_id	integer	Yes	The suppression list to attach.

Sample request

POST https://yourdomain.cakemarketing.com/api/2/offer_suppression_list.json

{
  "api_key": "YOUR_API_KEY",
  "offer_id": 1042,
  "suppression_list_id": 5
}

Sample response

{
  "request_status": "Success",
  "response": {
    "offer_id": 1042,
    "suppression_list_id": 5,
    "attached": true
  }
}

Get Optizmo Suppression Files

When to use: List available Optizmo suppression files for download by affiliates — use when building a custom affiliate portal that surfaces suppression file links, or when auditing Optizmo integration status.

GET/api/2/optizmo_suppression_files.json

Parameter	Type	Required	Description
api_key	string	Yes	Your CAKE API key.
offer_id	integer	No	Filter files associated with a specific offer.
affiliate_id	integer	No	Filter files available to a specific affiliate.

Sample request

GET https://yourdomain.cakemarketing.com/api/2/optizmo_suppression_files.json?api_key=YOUR_API_KEY&offer_id=1042

Sample response

{
  "request_status": "Success",
  "response": {
    "files": [
      {
        "file_id": 88,
        "file_name": "network_suppression_20260601.txt.gz",
        "offer_id": 1042,
        "download_url": "https://suppression.optizmo.net/files/88",
        "record_count": 142893,
        "file_date": "2026-06-01"
      }
    ]
  }
}

You may also be interested in:

If you have any questions, please reach out to your dedicated CAKE Client Success Manager/Account Manager or contact the CAKE Support Team at support@getCAKE.com.

This article will cover the following:

Overview

Key Concepts

Available Actions

Get Suppression Lists

Attach Suppression List to Offer

Get Optizmo Suppression Files

You may also be interested in:

Related Articles