Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

On this pageOverview

Retrieve Suppression

GET

/

suppressions

/

:suppression

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.suppressions.get(
  'e169aa45-1ecf-4183-9955-b1499d5701d3', // or: 'steve.wozniak@example.com'
);
PHP
$resend = Resend::client('re_xxxxxxxxx');

// Retrieve by suppression id
$resend->suppressions->get(
  'e169aa45-1ecf-4183-9955-b1499d5701d3'
);

// Retrieve by email
$resend->suppressions->get(
  'steve.wozniak@example.com'
);
Python
import resend

resend.api_key = "re_xxxxxxxxx"

# Retrieve by suppression id
resend.Suppressions.get("e169aa45-1ecf-4183-9955-b1499d5701d3")

# Retrieve by email
resend.Suppressions.get("steve.wozniak@example.com")
Ruby
require "resend"

Resend.api_key = "re_xxxxxxxxx"

# Retrieve by suppression id
Resend::Suppressions.get("e169aa45-1ecf-4183-9955-b1499d5701d3")

# Retrieve by email
Resend::Suppressions.get("steve.wozniak@example.com")
Go
package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	// Retrieve by suppression id
	client.Suppressions.Get("e169aa45-1ecf-4183-9955-b1499d5701d3")

	// Retrieve by email
	client.Suppressions.Get("steve.wozniak@example.com")
}
Rust
use resend_rs::{Resend, Result};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _data = resend
    .suppressions
    .get("e169aa45-1ecf-4183-9955-b1499d5701d3")
    .await?;

  Ok(())
}
Java
import com.resend.Resend;
import com.resend.core.exception.ResendException;

public class Main {
    public static void main(String[] args) throws ResendException {
        Resend resend = new Resend("re_xxxxxxxxx");

        // Retrieve by suppression id
        resend.suppressions().get("e169aa45-1ecf-4183-9955-b1499d5701d3");

        // Retrieve by email
        resend.suppressions().get("steve.wozniak@example.com");
    }
}
.NET
using Resend;

IResend resend = ResendClient.Create( "re_xxxxxxxxx" );

// Retrieve by suppression id
await resend.SuppressionRetrieveAsync( "e169aa45-1ecf-4183-9955-b1499d5701d3" );

// Retrieve by email
await resend.SuppressionRetrieveAsync( "steve.wozniak@example.com" );
cURL
# 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'
CLI
# Retrieve by suppression id
resend suppressions get e169aa45-1ecf-4183-9955-b1499d5701d3

# Retrieve by email
resend suppressions get steve.wozniak@example.com
Response
{
  "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-06 23:47:56.678+00"
}

A suppression can be retrieved either by its ID or by the suppressed email address.

email | id

required

The Suppression ID or email address.

The source_id in the response references the email that triggered the suppression. For suppressions with a manual origin, source_id is null.

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.suppressions.get(
  'e169aa45-1ecf-4183-9955-b1499d5701d3', // or: 'steve.wozniak@example.com'
);
PHP
$resend = Resend::client('re_xxxxxxxxx');

// Retrieve by suppression id
$resend->suppressions->get(
  'e169aa45-1ecf-4183-9955-b1499d5701d3'
);

// Retrieve by email
$resend->suppressions->get(
  'steve.wozniak@example.com'
);
Python
import resend

resend.api_key = "re_xxxxxxxxx"

# Retrieve by suppression id
resend.Suppressions.get("e169aa45-1ecf-4183-9955-b1499d5701d3")

# Retrieve by email
resend.Suppressions.get("steve.wozniak@example.com")
Ruby
require "resend"

Resend.api_key = "re_xxxxxxxxx"

# Retrieve by suppression id
Resend::Suppressions.get("e169aa45-1ecf-4183-9955-b1499d5701d3")

# Retrieve by email
Resend::Suppressions.get("steve.wozniak@example.com")
Go
package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	// Retrieve by suppression id
	client.Suppressions.Get("e169aa45-1ecf-4183-9955-b1499d5701d3")

	// Retrieve by email
	client.Suppressions.Get("steve.wozniak@example.com")
}
Rust
use resend_rs::{Resend, Result};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _data = resend
    .suppressions
    .get("e169aa45-1ecf-4183-9955-b1499d5701d3")
    .await?;

  Ok(())
}
Java
import com.resend.Resend;
import com.resend.core.exception.ResendException;

public class Main {
    public static void main(String[] args) throws ResendException {
        Resend resend = new Resend("re_xxxxxxxxx");

        // Retrieve by suppression id
        resend.suppressions().get("e169aa45-1ecf-4183-9955-b1499d5701d3");

        // Retrieve by email
        resend.suppressions().get("steve.wozniak@example.com");
    }
}
.NET
using Resend;

IResend resend = ResendClient.Create( "re_xxxxxxxxx" );

// Retrieve by suppression id
await resend.SuppressionRetrieveAsync( "e169aa45-1ecf-4183-9955-b1499d5701d3" );

// Retrieve by email
await resend.SuppressionRetrieveAsync( "steve.wozniak@example.com" );
cURL
# 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'
CLI
# Retrieve by suppression id
resend suppressions get e169aa45-1ecf-4183-9955-b1499d5701d3

# Retrieve by email
resend suppressions get steve.wozniak@example.com
JSON
{
  "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-06 23:47:56.678+00"
}

Was this page helpful?

⌘I

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu