API Reference
Retrieve Suppression
GET /suppressions/:id_or_email — one suppression, by id or by address.
GET
/suppressions/:id_or_emailLooks 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_emailstringrequiredA 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.