Suppressions
Export the suppression list as CSV
GET
The whole suppression list of the API key's environment (optionally filtered), oldest first, as CSV with the columns address,scope,reason,created_at,email_id,id. The file can be imported again as is. Values a spreadsheet would run as a formula are prefixed with '.
bearerAuthheader
AuthorizationBearer <token>A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.
scope?|Only entries with this scope.
reason?stringOnly entries with this reason.
Value in
"bounce""complaint""manual""import"Coss-Version?"2026-10-10"The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.
Value in
"2026-10-10"The CSV file.
response?stringtext/csvimport { Coss } from "coss";const coss = new Coss({ apiKey: process.env.COSS_API_KEY, baseUrl: "https://api.coss.com",});const { data, error } = await coss.email.suppressions.export();"string"