Skip to main content
GET
/
v1
/
suppressions
curl https://www.unosend.co/api/v1/suppressions?limit=10 \
  -H "Authorization: Bearer un_your_api_key"

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email": "[email protected]",
      "reason": "hard_bounce",
      "source_email_id": "email_abc123",
      "metadata": {
        "bounce_type": "Permanent",
        "bounce_subtype": "NoEmail"
      },
      "created_at": "2024-01-15T10:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

​
Query Parameters

​
limit
number
default:"50"
Number of results per page (max 100)
​
cursor
string
Pagination cursor from previous response
​
reason
string
Filter by suppression reason:
  • hard_bounce - Invalid email addresses
  • spam_complaint - Spam reports
  • manual - Manually added
  • unsubscribe - Unsubscribed recipients

​
Response

​
data
array
​
has_more
boolean
Whether more results are available
​
next_cursor
string
Cursor for fetching the next page
curl https://www.unosend.co/api/v1/suppressions?limit=10 \
  -H "Authorization: Bearer un_your_api_key"

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email": "[email protected]",
      "reason": "hard_bounce",
      "source_email_id": "email_abc123",
      "metadata": {
        "bounce_type": "Permanent",
        "bounce_subtype": "NoEmail"
      },
      "created_at": "2024-01-15T10:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}