Remove in bulk
POST
/suppressions/batch/removeAuthorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Request body
requiredapplication/jsonemailsstring<email>[]Addresses to unblock, up to 1000
min items 1 · max items 1000
idsstring<uuid>[]Suppression ids to remove, up to 1000
min items 1 · max items 1000
Responses
200
Exactly one of emails or ids (up to 1000 each); lists only the rows actually removed. 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.
dataRemoveSuppressionResponse[]requiredShow propertiesHide properties
Array of
RemoveSuppressionResponseobjectstringrequiredAllowed:
suppressionidstring<uuid>requireddeletedbooleanrequiredAllowed:
true401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired422
Validation error
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired