Check addresses against the suppression list
For up to 100 comma-separated addresses, whether each is on the suppression list, why, and for a SOFT_BOUNCE_REPEATED entry when it lifts (expiresAt).
https://app.usenotix.dev/api/v1/suppressions/checkFull access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
For up to 100 comma-separated addresses, whether each is on the suppression list, why, and for a SOFT_BOUNCE_REPEATED entry when it lifts (expiresAt). A hard bounce, complaint or manual entry stops every send; a SOFT_BOUNCE_REPEATED entry stops campaigns and automations only.
Query parameters
Up to 100 addresses, separated by commas.
Headers
Bearer followed by your API key.
Errors
More than the allowed number of addresses, or an address that is not valid.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/suppressions/check" \
-H "Authorization: Bearer $NOTIX_API_KEY"
{
"results": [
{
"email": "customer@example.com",
"suppressed": true,
"reason": "HARD_BOUNCE",
"expiresAt": "2026-10-01T09:00:00Z"
}
]
}