Retrieve the organization's sending reputation
The organization's standing with the COSS reputation guard and the latest rates it measured over live environments. When a rate reaches its suspension threshold, live sending is suspended automatically (account_suspended) until COSS support reinstates the organization; sandbox keys keep working. Subscribe to the account.* webhook events to be notified of changes.
bearerAuthAuthorizationBearer <token>A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.
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.
"2026-10-10"The organization's reputation.
application/json- response
object*"reputation""reputation"status*stringgood, warning (a rate is approaching the suspension threshold) or suspended (live sending is refused until COSS support reinstates the organization).
"good""warning""suspended"reason*|The trigger behind a warning or suspended status.
status_changed_at*|date-timeevaluated_at*|When the checks below were computed; null before the first evaluation.
date-timewindow*|The period the checks cover (live environments only).
checks*array<>import { Coss } from "coss";const coss = new Coss({ apiKey: process.env.COSS_API_KEY, baseUrl: "https://api.coss.com",});const { data, error } = await coss.reputation.get();{ "object": "reputation", "status": "good", "reason": "string", "status_changed_at": "2019-08-24T14:15:22Z", "evaluated_at": "2019-08-24T14:15:22Z", "window": { "start": "2019-08-24T14:15:22Z", "end": "2019-08-24T14:15:22Z" }, "checks": [ { "trigger": "string", "severity": "ok", "message": "string", "rate": 0, "count": 0, "volume": 0, "warning_threshold": 0, "suspend_threshold": 0, "minimum_volume": 0 } ]}List log lines GET
The API key's environment log, newest first: every API request made with one of its keys (`source: api`), every email event (`email`) and every webhook delivery attempt (`webhook`). Filter by time range (an hour by default, at most 31 days), source, level, type, status, method, route, key, request, resource or free text. Pass the last `id` as `after` to get the next page while `has_more` is true. Reading logs is not itself logged.
Check whether an address is suppressed GET
Whether a send to `address` (with `category`, if given) would skip it, and the entries that match: those with scope `*` and, with a `category`, those for that category.