List suppressions
Newest first, with cursor pagination: after takes the last id of a page and pages toward older items, before takes the first id and pages back toward newer ones.
/suppressionsAuthorizationToken Bearer · headerobrigatórioA BillionSend API key (bs_…).
limitintegerPage size, 1-100 (default 20)
afterstring<uuid>Cursor: id of the last item of the current page; returns the next page. Must be an id this list returned; there is no sentinel value.
beforestring<uuid>Cursor: id of the first item of the current page; returns the previous page; same rule as after.
originstringOnly suppressions of this origin: bounce, complaint or manual
bouncecomplaintmanualSuppressions, optionally filtered by origin (bounce, complaint or manual). 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.
objectstringobrigatóriolistdataobject[]obrigatórioMostrar propriedadesOcultar propriedades
objectidstring<uuid>obrigatórioemailstringobrigatóriooriginstringobrigatóriobouncecomplaintmanualsource_idstring<uuid> | nullobrigatórioEmail id whose bounce/complaint created the entry
created_atstringobrigatóriohas_morebooleanobrigatórioMissing, malformed, unknown or revoked API key
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioValidation error
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioOver the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório