Ctrl+K

Find blocked email (admin)

get/api/notifications/v1/admin/email/blocked

Retrieves block information for a specified email address. Returns permanent block details (bounce/complaint) and/or transient block status with remaining TTL. Returns 404 only if the email is neither permanently nor temp-blocked.

Query Parameters

  • emailstringRequired
    Min length: >= 1 characters

200 Response

id string <uuid>
email string required
detail string
isBounced boolean required
isComplaint boolean required
createdAt string <date-time>required
isTempBlocked boolean required
tempBlockExpiresInSeconds integer <int64>

400 Response

name string required
Error code
Allowed values: ValidationFailed IllegalArgument BadRequest DataIntegrityError NotImplementedError RETRIGGER_RATE_LIMITED USER_CREATION_FAILED USER_FALLBACK_FAILED
error string required
Human-readable error message
status integer <int32>required
HTTP status code
Allowed value: 400

403 Response

name string required
Error code
Allowed value: AccessDenied
error string required
Human-readable error message
status integer <int32>required
HTTP status code
Allowed value: 403

404 Response

name string required
Error code
Allowed value: NotFound
error string required
Human-readable error message
status integer <int32>required
HTTP status code
Allowed value: 404

500 Response

name string required
Error code
Allowed values: UnexpectedError ThirdPartyError DatabaseError USER_FALLBACK_TIMEOUT
error string required
Human-readable error message
status integer <int32>required
HTTP status code
Allowed value: 500