Retrieve a suppression
GET
/suppressions/{id}Authorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
idstringrequiredmin length 1
Responses
200
Suppression by id or by email address. Rows whose address was erased (GDPR/LGPD) keep blocking sends but are hidden from the list and from lookups by email; they are reachable by id only. An erased row reports "[erased]" as its email.
idstring<uuid>requiredemailstringrequiredoriginstringrequiredAllowed:
bouncecomplaintmanualsource_idstring<uuid> | nullrequiredEmail id whose bounce/complaint created the entry
created_atstringrequiredobjectstringrequiredAllowed:
suppression401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired