Returns a page of bounces. For a list of bounce codes, please check this page: bounce codes.
Bounces are collected when they are final, i.e. while the mailserver tries to submit a mailing and a temporal error (e.g. mailbox is full) is detected, the bounce is registered after the mailserver gave up retrying to deliver the mailing.

Attributes

Parameter Default Description
from_date   If provided, only the bounces after or equal (including) the given date will be returned. The value of from_date must be a numeric value representing a point in time milliseconds after January 1, 1970 00:00:00
to_date   If provided, only the bounces before (excluding) the given date will be returned.  The value of to_date must be a numeric value representing a point in time milliseconds afterJanuary 1, 1970 00:00:00
mailing_id   Multivalued parameter to filter the bounces by mailings. Each value must correspond to a mailing id.
ids Multivalued parameter to filter the results by contacts. Each value must correspond to a contact id.
emails Multivalued parameter to filter the results by email addresses.
eids Multivalued parameter to filter the results by external ids. Each value must correspond to a contacts external id
status_code   Filters the bounces by status codes. Status codes follow the pattern digit.digit.digit (example: 5.0.0)
type   Filters the bounces by type: permanent / transient
source_filter   Filters the bounces by their source: mta-listener / reply
exclude_anonymous_bounces true Supported values: true / false. If set to true, the bounces that cannot be mapped to contacts because of permission types or because unsubscriptions are omitted in the results.
standard_field   Multivalued parameter to query the value of a standard contact field.
custom_field Multivalued parameter to query the value of a custom contact field.
embed_field_backups false Supported values: true / false. Field Backups are the values of contact fields that have been backed up for mailings because of a backup instruction. For each bounce, the corresponding field backups will be returned if available.
page_index  1 The index of the result page. The index must be greater or equal to 1.
page_size 100 The maximum count of items in the result page. If provided, the value of page_size must be in the range 1 to 1000.

Example