v1

latestSwagger 2.02026-08-0613288149.8 KB
bounces

Get all bounces for your account. ๐Ÿ”

returns a list with all bounces for your account<br /> <br /> We categorize bounces according to the messages from the receiving mailserver:<br /> <br /> Categories (exerpt):<br /> - <code>permanent/hardbounce</code>: mailbox does not exist<br /> - <code>softbounce</code>: temporary errors<br /> - <code>blocked</code>: receiving mailserver didn't accept our email<br /> - <code>delayed</code>: temporary delivery error<br /> - <code>spam</code>: receiving mailserver categorized your email as spam<br /> <br /> There are also two types of bounces:<br /> - type: <code>mailing</code> -- bounce was created through a mailing<br /> - type: <code>doi</code> -- bounce was created while sending the DOI emails (form signup)<br /> <code>type_id</code> is either the mailing id or the form id depending on the type <br /> <br /> <strong>Example response data:</strong><br /> <code> {<br /> ย ย "email": "batman@gotham.com",<br /> ย ย "category": "hardbounce",<br /> ย ย "occurences": 1,<br /> ย ย "last_update": 1595229122,<br /> ย ย "last_update_gmt": "2020-07-20T07:12:02+00:00",<br /> ย ย "expires_by": 1626855819,<br /> ย ย "expires_by_gmt": "2021-07-21T08:23:39+00:00",<br /> ย ย "bounce_message": "smtp; 550 Recipient does not exist",<br /> ย ย "type": "doi",<br /> ย ย "type_id": "12345678"<br /> },<br /> </code><br /> <br /> <strong>The pagesize is limited to 500. To get more, retrieve another page.</strong> <br />

get/v3/bounces

Query parameters

pagesizeinteger

max amount of entries per query

pageinteger

page

Response

Success

string[] required