> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unosend.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List Suppressions

> Retrieve a paginated list of suppressed email addresses.

## Query Parameters

<ParamField query="page" type="number" default="1">
  Page number
</ParamField>

<ParamField query="per_page" type="number" default="50">
  Number of results per page (max 100)
</ParamField>

<ParamField query="reason" type="string">
  Filter by suppression reason:

  * `hard_bounce` - Invalid email addresses
  * `spam_complaint` - Spam reports
  * `manual` - Manually added
  * `unsubscribe` - Unsubscribed recipients
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the request was successful
</ResponseField>

<ResponseField name="data" type="array">
  <Expandable title="Suppression object">
    <ResponseField name="id" type="string">
      Unique suppression identifier
    </ResponseField>

    <ResponseField name="email" type="string">
      Suppressed email address
    </ResponseField>

    <ResponseField name="reason" type="string">
      Reason for suppression
    </ResponseField>

    <ResponseField name="source_email_id" type="string">
      ID of the email that caused the suppression (if applicable)
    </ResponseField>

    <ResponseField name="metadata" type="object">
      Additional information about the suppression
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  <Expandable title="Pagination metadata">
    <ResponseField name="total" type="number">
      Total number of suppressions
    </ResponseField>

    <ResponseField name="page" type="number">
      Current page number
    </ResponseField>

    <ResponseField name="page_size" type="number">
      Number of results per page
    </ResponseField>

    <ResponseField name="pages" type="number">
      Total number of pages
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.unosend.co/suppressions?page=1&per_page=10" \
    -H "Authorization: Bearer un_your_api_key"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.unosend.co/suppressions?page=1&per_page=10', {
    headers: {
      'Authorization': 'Bearer un_your_api_key'
    }
  });
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.unosend.co/suppressions',
      params={'page': 1, 'per_page': 10},
      headers={'Authorization': 'Bearer un_your_api_key'}
  )
  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "email": "bounced@example.com",
        "reason": "hard_bounce",
        "source_email_id": "email_abc123",
        "metadata": {
          "bounce_type": "Permanent",
          "bounce_subtype": "NoEmail"
        },
        "created_at": "2024-01-15T10:30:00.000Z"
      }
    ],
    "meta": {
      "total": 42,
      "page": 1,
      "page_size": 10,
      "pages": 5
    }
  }
  ```
</ResponseExample>