API Reference

Retrieve Suppression

GET /suppressions/:id_or_email — one suppression, by id or by address.

GET/suppressions/:id_or_email

Looks up one suppression. Pass its id, or the address itself to check whether an address is blocked. When an address has both an account-wide row and a row for one sending domain, the account-wide row is returned.

Needs an API key with read access.
Path parameters
id_or_emailstringrequired

A suppression id, or an email address (URL-encode the @ as %40 if your client does not).

const res = await fetch('https://www.senddart.com/api/suppressions/48213', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);

Response

{
  "object": "suppression",
  "id": "48213",
  "email": "pat@example.com",
  "origin": "manual",
  "domain": null,
  "created_at": "2026-11-20T09:14:02.000Z"
}

An address that is not on the list returns 404 not_found. A value that is neither an id nor an address returns 422 validation_error.