DocsSuppressions ▾
IntroductionQuickstartAuthenticationSending emailDomainsAPI keysSMTP relayWebhooksTemplatesBroadcastsAudiences & contactsSuppression listOpen & click trackingIP warm-upDeliverabilityAnalytics & logsLimits & errorsEmailsDomainsAPI keysAudiences & contactsBroadcastsTemplatesWebhooksSuppressionsMetrics
API reference
Suppressions API
List, add and remove suppressed addresses.
List suppressions
Lists up to 500 suppressed addresses, newest first.
GET/suppressions
Request
curl -X GET 'https://api.mailvina.com/suppressions' \
-H 'Authorization: Bearer mv_xxxxxxxxx'Response
{
"object": "list",
"data": [
{
"email": "[email protected]",
"reason": "bounce",
"created_at": "2026-11-14T10:00:00.000Z"
}
]
}Add suppression
Suppresses an address so it never receives email from your team.
POST/suppressions
Body parameters
| Name | Type | Description |
|---|---|---|
emailrequired | string | Address to suppress. |
Request
curl -X POST 'https://api.mailvina.com/suppressions' \
-H 'Authorization: Bearer mv_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d '{
"email": "[email protected]"
}'Response
{
"email": "[email protected]"
}Remove suppression
Removes an address from the list so it can receive email again.
DELETE/suppressions/:email
Path parameters
| Name | Type | Description |
|---|---|---|
emailrequired | string | URL-encoded address. |
Request
curl -X DELETE 'https://api.mailvina.com/suppressions/:email' \
-H 'Authorization: Bearer mv_xxxxxxxxx'Response
{
"deleted": true
}