API Reference

List Suppressions

GET /suppressions — the addresses SendDart will not mail, newest first.

GET/suppressions

Lists your suppression list, newest first, one page at a time. Filter by how an address got there, by part of the address, or by when it was added.

Needs an API key with read access. This list is paginated; see Pagination.
Query parameters
limitnumberoptional

Rows per page, 1 to 100. Default 20.

afterstringoptional

A suppression id. Returns the rows after it (the next page). Cannot be combined with before.

beforestringoptional

A suppression id. Returns the rows before it (the previous page). Cannot be combined with after.

originstringoptional

Only rows with this origin: bounce, complaint, manual or unsubscribe.

searchstringoptional

Case-insensitive match on any part of the address.

created_afterstringoptional

Only rows added at or after this time (ISO 8601).

created_beforestringoptional

Only rows added before this time (ISO 8601).

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

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "suppression",
      "id": "48213",
      "email": "pat@example.com",
      "origin": "bounce",
      "domain": null,
      "created_at": "2026-11-20T09:14:02.000Z"
    }
  ]
}

An unknown origin, a malformed date, a limit outside 1–100, or after and before together returns 422 validation_error.