# List all suppressions

Retrieve all system-managed suppressions (hard bounces, soft bounces, and spam complaints) with filtering capabilities.

Use this to:
- Monitor bounce and complaint trends
- Export comprehensive suppression lists
- Filter by type, domain, or date range
- Track suppression sources and reasons
- Manage whitelist overrides

Suppression Types:
- bounce: Hard and soft bounces (added automatically by the system)
- complaint: Spam complaints and feedback loop reports (added automatically)

Each suppression includes a scope field indicating whether it's global (all domains) or domain-specific.

Note: For user opt-outs and unsubscribes, see the /api/v1/customer/unsubscribes endpoints.

Endpoint: GET /api/customer/suppressions
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `page` (integer)

  - `limit` (integer)

  - `search` (string)
    Search by email address (partial match)

  - `type` (string)
    Filter by suppression type
    Enum: "bounce", "complaint", "unsubscribe"

  - `domain_id` (string)
    Filter by specific domain

  - `from_date` (string)
    Filter from date (YYYY-MM-DD)

  - `to_date` (string)
    Filter to date (YYYY-MM-DD)

## Response 200 fields (application/json):

  - `suppressions` (array)

  - `suppressions.id` (string)

  - `suppressions.email` (string)

  - `suppressions.type` (string)
    Enum: "bounce", "complaint", "unsubscribe"

  - `suppressions.reason` (string)

  - `suppressions.source` (string)

  - `suppressions.domain_id` (string,null)

  - `suppressions.domain` (string,null)

  - `suppressions.scope` (string)
    Enum: "global", "domain-specific"

  - `suppressions.created_at` (string)

  - `counts` (object)

  - `counts.bounce` (integer)

  - `counts.complaint` (integer)

  - `counts.unsubscribe` (integer)

  - `pagination` (object)

  - `pagination.page` (integer)

  - `pagination.limit` (integer)

  - `pagination.total` (integer)
    Total number of items

  - `pagination.pages` (integer)
    Total number of pages

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 500 fields (application/json):

  - `error` (string)
    Error code or message