Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

list_suppressions

View as .md

Unsubscribes.

Lists the addresses and domains blocked for this space (unsubscribes, complaints, manual additions), newest first. With a full address in query, also says whether it is a dead address known across the platform. Cursor pagination.

Access

  • Key: an Escouade Mail key with read.
  • Space: any space, verified or not.
  • Changes nothing: yes, it only reads.
  • Safe to replay: yes.

Parameters

ParameterTypeRequiredDescription
querystringnoPart of an address or domain; a full address to find out whether it is dead.
cursorstringnoCursor of the next page: the next_cursor value from the previous call.
limitintegernoNumber of items returned (20 by default).

Call it

Terminal
curl -s https://api.subagent.fr/v1/list_suppressions \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/list_suppressions.