Suppressions

List suppressions

GET

/api/v1/suppressions

Query parameters

cursor

optional

string

limit

optional

integer

reason

optional

"manual" | "unsubscribed" | "not_interested" | "existing_customer" | "open_opportunity" | "competitor" | "employee" | "invalid_recipient" | "complained" | "recently_contacted" | "unresponsive"

Response

200A page of suppression entries, newest first. Pass nextCursor as cursor for the next page.

suppressions

object[]

nextCursor

string | null

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy