---
title: "Get bounces"
method: GET
path: "/bounces"
tags: ["Bounces API"]
---

# Get bounces

`GET /bounces`

## Query parameters

- `count` integer, required
- `offset` integer, required
- `type` 'HardBounce' | 'Transient' | 'Unsubscribe' | 'Subscribe' | 'AutoResponder' | 'AddressChange' | 'DnsError' | 'SpamNotification' | 'OpenRelayTest' | 'Unknown' | 'SoftBounce' | 'VirusNotification' | 'MailFrontier Matador.' | 'BadEmailAddress' | 'SpamComplaint' | 'ManuallyDeactivated' | 'Unconfirmed' | 'Blocked' | 'SMTPApiError' | 'InboundError' | 'DMARCPolicy' | 'TemplateRenderingFailed'
- `inactive` boolean
- `emailFilter` string, email
- `messageID` string
- `tag` string
- `todate` string, date
- `fromdate` string, date

## Headers

- `X-Postmark-Server-Token` string, required

## Response `200`

OK

- BounceSearchResponse
  - `TotalCount` integer
  - `Bounces` BounceInfoResponse[]
    - `ID` string
    - `Type` string
    - `TypeCode` integer
    - `Name` string
    - `Tag` string
    - `MessageID` string
    - `Description` string
    - `Details` string
    - `Email` string, email
    - `BouncedAt` string, date-time
    - `DumpAvailable` boolean
    - `Inactive` boolean
    - `CanActivate` boolean
    - `Subject` string
    - `Content` string

## Other responses

- `422` — An error was generated due to incorrect use of the API. See the Message associated with this response for more information.
- `500` — Indicates an internal server error occurred.

---

[API](https://skmtc.net/postmarkapp/apis/postmark-api.md) · [All operations](https://skmtc.net/postmarkapp/apis/postmark-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postmarkapp/postmark-api/versions/fdae25f55e2e/schema)