# Suppressions

Source: https://kirora.io/docs/api/reference/suppressions

A suppression is a block on an email address, held whether or not a contact has it, with its reason. A bounce (`bounced`) or a spam complaint about a transactional message (`complained_transactional`) stops all email, transactional included. An unsubscribe (`unsubscribed`), a spam complaint about marketing mail (`complained`) and a block you add (`manual`, `imported`) stop marketing only: receipts, password resets and other transactional email still send.

## Endpoints

- [List suppressed email addresses](https://kirora.io/docs/api/reference/listSuppressions): `GET /v1/suppressions`
- [Add suppressed email addresses](https://kirora.io/docs/api/reference/addSuppressions): `POST /v1/suppressions`
- [Delete suppressed email addresses](https://kirora.io/docs/api/reference/deleteSuppressions): `POST /v1/suppressions/delete`

## The Suppression object

```json
{
  "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
  "channel": "email",
  "address": "address_example",
  "reason": "manual",
  "removable": true,
  "createdAt": "2030-03-14T09:30:00Z"
}
```

- `id` (string, required, uuid)
- `channel` ("email", required)
- `address` (string, required)
- `reason` (string, required, one of `manual`, `imported`, `unsubscribed`, `bounced`, `complained`, `complained_transactional`) — Why the address is blocked: `manual` (blocked by a person), `imported` (added through `addSuppressions`), `unsubscribed`, `bounced`, `complained` (marked as spam on marketing mail) or `complained_transactional` (marked as spam on a transactional message).
- `removable` (boolean, required) — True for `manual` and `imported`; bounces, complaints and unsubscribes cannot be removed.
- `createdAt` (string, required, date-time)