Skip to main content
GET
/
suppressions
curl "https://api.unosend.co/suppressions?page=1&per_page=10" \
  -H "Authorization: Bearer un_your_api_key"

{
  "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
  }
}

​
Query Parameters

​
page
number
default:"1"
Page number
​
per_page
number
default:"50"
Number of results per page (max 100)
​
reason
string
Filter by suppression reason:
  • hard_bounce - Invalid email addresses
  • spam_complaint - Spam reports
  • manual - Manually added
  • unsubscribe - Unsubscribed recipients

​
Response

​
success
boolean
Whether the request was successful
​
data
array
​
meta
object
curl "https://api.unosend.co/suppressions?page=1&per_page=10" \
  -H "Authorization: Bearer un_your_api_key"

{
  "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
  }
}