Look up one suppressed recipient

Search Documentation

Search across all developer documentation

suppressions

Look up one suppressed recipient

GET /v1/suppressions/{email}
Auth required suppressions.view

Returns the suppression record for an exact email address, or 404 not_found when the address is not on your SES suppression list. Match is case-insensitive, but the returned email preserves SES's stored casing. Newly-added suppressions can take up to a minute to appear here. Percent-encode @ as %40 (e.g. user%40example.com).

Path parameters

email string<email> required

Recipient address. Percent-encode @ as %40. Matched case-insensitively.

Responses

200 The suppression record application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
422 Query parameter or path value failed validation application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json