Bounces
Search bounces, inspect their raw source and reactivate addresses that Postmark deactivated.
Get bounces
Searches bounces on the server. A search can return up to 10,000 bounces; use fromdate and todate to narrow larger sets.
query Parameters
countNumber of records to return per request. Max 500. count + offset cannot exceed 10,000.
offsetNumber of records to skip. count + offset cannot exceed 10,000.
typeFilter by bounce type.
Type of bounce. See the Bounce types section of the Postmark docs for what each value means.
inactiveFilter by whether Postmark deactivated the address because of the bounce. When omitted, both active and inactive bounces are returned.
emailFilterFilter by email address.
tagFilter by tag.
messageIDFilter by the ID of the bounced message.
fromdateReturn records starting from this date/time (inclusive), e.g. 2026-01-01T12:00:00. Postmark uses US Eastern Time.
todateReturn records up to this date/time (inclusive), e.g. 2026-01-31T12:00:00. Postmark uses US Eastern Time.
messagestreamFilter by message stream ID. Defaults to the outbound transactional stream when omitted.
Get bounces › Responses
A page of bounces.
TotalCountNumber of bounces matching the search. May exceed the number returned in one call.
Bounces for the requested page.
Get a single bounce
Returns the details of one bounce, including the raw bounce Content.
path Parameters
bounceIdUnique ID of the bounce.
Get a single bounce › Responses
The bounce.
IDUnique ID of the bounce. Field of Bounce.
TypeType of bounce. See the Bounce types section of the Postmark docs for what each value means.
TypeCodeNumeric code of the bounce type.
NameDisplay name of the bounce type.
TagTag of the bounced message.
MessageIDID of the message that bounced.
ServerIDID of the server that sent the message.
MessageStreamMessage stream the message was sent through.
DescriptionShort description of the bounce reason.
DetailsDetailed reason reported by the receiving server.
EmailEmail address that bounced.
FromSender address of the bounced message.
BouncedAtTime the bounce occurred.
DumpAvailableWhether the raw SMTP dump is available (see Get bounce dump).
InactiveWhether Postmark deactivated the address because of this bounce.
CanActivateWhether the address can be reactivated.
SubjectSubject of the bounced message.
ContentRaw content of the bounce. Only returned when fetching a single bounce.
Activate a bounce
Reactivates an address that Postmark deactivated because of a bounce, so it can receive email again. Not possible for every bounce type; check CanActivate first (otherwise error code 1003).
path Parameters
bounceIdUnique ID of the bounce.
Activate a bounce › Responses
The reactivated bounce.
MessageResult of the reactivation attempt.
A bounce record.
Get bounce dump
Returns the raw SMTP source of a bounce. Only available while DumpAvailable is true on the bounce.
path Parameters
bounceIdUnique ID of the bounce.
Get bounce dump › Responses
The raw bounce source.
BodyRaw SMTP source of the bounce. Empty string when no dump is available.
Get delivery stats
Returns a summary of inactive emails and bounces by type for the server.
Get delivery stats › Responses
Bounce summary for the server.
InactiveMailsNumber of addresses currently deactivated because of bounces.
Bounce counts grouped by type. The entry named All is the total.