--- title: "Get all bounces for your account. ๐Ÿ”" method: GET path: "/v3/bounces" tags: ["bounces"] --- # Get all bounces for your account. ๐Ÿ” `GET /v3/bounces` returns a list with all bounces for your account

We categorize bounces according to the messages from the receiving mailserver:

Categories (exerpt):
- permanent/hardbounce: mailbox does not exist
- softbounce: temporary errors
- blocked: receiving mailserver didn't accept our email
- delayed: temporary delivery error
- spam: receiving mailserver categorized your email as spam

There are also two types of bounces:
- type: mailing -- bounce was created through a mailing
- type: doi -- bounce was created while sending the DOI emails (form signup)
type_id is either the mailing id or the form id depending on the type

Example response data:
{
  "email": "batman@gotham.com",
  "category": "hardbounce",
  "occurences": 1,
  "last_update": 1595229122,
  "last_update_gmt": "2020-07-20T07:12:02+00:00",
  "expires_by": 1626855819,
  "expires_by_gmt": "2021-07-21T08:23:39+00:00",
  "bounce_message": "smtp; 550 Recipient does not exist",
  "type": "doi",
  "type_id": "12345678"
},


The pagesize is limited to 500. To get more, retrieve another page.
## Query parameters - `pagesize` integer - `page` integer ## Response `200` Success - string[] --- [API](https://skmtc.net/cleverreach/apis/cleverreach-rest-api.md) ยท [All operations](https://skmtc.net/cleverreach/apis/cleverreach-rest-api/llms.txt) ยท [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleverreach/cleverreach-rest-api/revisions/7248a065f67f/schema)