Suppressions

Search suppressions

Find suppressions by person, company domain, note, or reason. Every word in query must appear. Suppressions whose person or domain starts with the query come first, then by email. Pass nextCursor as cursor, with the same query, for the next page. Use the id with Delete a suppression.

POST

/api/v1/suppressions/search

Request bodyrequired

queryrequired

string

Text to match. Every word must appear in the record.

cursoroptional

string

limitoptional

integer

Response

200Matching suppressions.

suppressions

object[]

nextCursor

string | null

requestId

string · uuid

Id of this request, for support and troubleshooting

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