List suppressions
GET/v1/suppressions
Active suppressions, newest first, with cursor pagination.
Required scope: suppressions:manage
Parameters
| Name | In | Description |
|---|---|---|
limitoptional | query | Page size, 1 to 100. Default 20. |
cursoroptional | query | The next_cursor from a previous page. |
Example
curl -X GET 'https://api.sendsend.email/v1/suppressions' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"data": [
{
"id": "sup_4Gh2…",
"object": "suppression",
"address": "maria@example.com",
"reason": "bounce",
"source": "provider",
"created_at": "2026-10-06T15:00:00.000Z"
}
],
"next_cursor": null
}Errors
| Status | Code | When |
|---|---|---|
| 400 | validation_error | The request body or parameters are invalid. The message says which field. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
Every error has the same shape. See Errors.