import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
// Retrieve by suppression id
const { data, error } = await resend.suppressions.get(
'e169aa45-1ecf-4183-9955-b1499d5701d3',
);
// Retrieve by email
const { data, error } = await resend.suppressions.get(
'steve.wozniak@example.com',
);
# Retrieve by suppression id
curl -X GET 'https://api.resend.com/suppressions/e169aa45-1ecf-4183-9955-b1499d5701d3' \
-H 'Authorization: Bearer re_xxxxxxxxx'
# Retrieve by email
curl -X GET 'https://api.resend.com/suppressions/steve.wozniak@example.com' \
-H 'Authorization: Bearer re_xxxxxxxxx'
{
"object": "suppression",
"id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
"email": "steve.wozniak@example.com",
"origin": "bounce",
"source_id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
"created_at": "2026-10-06T23:47:56.678Z"
}
Retrieve Suppression
Retrieve a single suppression by ID or email.
GET
/
suppressions
/
:suppression
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
// Retrieve by suppression id
const { data, error } = await resend.suppressions.get(
'e169aa45-1ecf-4183-9955-b1499d5701d3',
);
// Retrieve by email
const { data, error } = await resend.suppressions.get(
'steve.wozniak@example.com',
);
# Retrieve by suppression id
curl -X GET 'https://api.resend.com/suppressions/e169aa45-1ecf-4183-9955-b1499d5701d3' \
-H 'Authorization: Bearer re_xxxxxxxxx'
# Retrieve by email
curl -X GET 'https://api.resend.com/suppressions/steve.wozniak@example.com' \
-H 'Authorization: Bearer re_xxxxxxxxx'
{
"object": "suppression",
"id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
"email": "steve.wozniak@example.com",
"origin": "bounce",
"source_id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
"created_at": "2026-10-06T23:47:56.678Z"
}
The Suppressions API is currently in private beta and only available to a
limited number of users. APIs might change before GA.
Get in touch if you’re interested in testing
this feature.Once you have access, upgrade your Resend SDK to use the methods on this
page:
npm install resend@6.18.0-canary.0
Path Parameters
The Suppression ID or email address.
source_id in the response references the email that triggered the
suppression. For suppressions with a manual origin, source_id is null.
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
// Retrieve by suppression id
const { data, error } = await resend.suppressions.get(
'e169aa45-1ecf-4183-9955-b1499d5701d3',
);
// Retrieve by email
const { data, error } = await resend.suppressions.get(
'steve.wozniak@example.com',
);
# Retrieve by suppression id
curl -X GET 'https://api.resend.com/suppressions/e169aa45-1ecf-4183-9955-b1499d5701d3' \
-H 'Authorization: Bearer re_xxxxxxxxx'
# Retrieve by email
curl -X GET 'https://api.resend.com/suppressions/steve.wozniak@example.com' \
-H 'Authorization: Bearer re_xxxxxxxxx'
{
"object": "suppression",
"id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
"email": "steve.wozniak@example.com",
"origin": "bounce",
"source_id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
"created_at": "2026-10-06T23:47:56.678Z"
}
Was this page helpful?
⌘I