Postmark

Postmark Bounces API API

The Bounces API API from Postmark — 5 operation(s) for bounces api.

GitHub OpenAPI

Operations 5

GET /deliverystats Postmark Get delivery stats #
GET /bounces Postmark Get bounces #
GET /bounces/{bounceid} Postmark Get a single bounce #
GET /bounces/{bounceid}/dump Postmark Get bounce dump
PUT /bounces/{bounceid}/activate Postmark Activate a bounce #

Documentation

📖
Documentation
https://postmarkapp.com/developer
📖
GettingStarted
https://postmarkapp.com/developer/api/overview
📖
Authentication
https://postmarkapp.com/developer/api/overview#authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/postmark/refs/heads/main/openapi/postmark-bounces-api-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/postmark/refs/heads/main/asyncapi/postmark-webhooks-asyncapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/postmark/refs/heads/main/overlays/postmark-bounces-api-api-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/postmark-bounces-api-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

postmark-bounces-api-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Postmark Server Bounces API
  description: 'Postmark makes sending and receiving email

    incredibly easy.

    '
  version: 1.0.0
servers:
- url: https://api.postmarkapp.com/
tags:
- name: Bounces API
paths:
  /deliverystats:
    get:
      operationId: getDeliveryStats
      summary: Postmark Get delivery stats
      tags:
      - Bounces API
      parameters:
      - name: X-Postmark-Server-Token
        required: true
        description: The token associated with the Server on which this request will operate.
        in: header
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeliveryStatsResponse'
        422:
          $ref: '#/components/responses/422'
        500:
          $ref: '#/components/responses/500'
  /bounces:
    get:
      operationId: getBounces
      tags:
      - Bounces API
      summary: Postmark Get bounces
      parameters:
      - name: X-Postmark-Server-Token
        required: true
        description: The token associated with the Server on which this request will operate.
        in: header
        schema:
          type: string
      - name: count
        in: query
        description: Number of bounces to return per request. Max 500.
        required: true
        schema:
          type: integer
          maximum: 500
      - name: offset
        description: Number of bounces to skip.
        in: query
        required: true
        schema:
          type: integer
      - name: type
        description: Filter by type of bounce
        in: query
        schema:
          type: string
          enum:
          - HardBounce
          - Transient
          - Unsubscribe
          - Subscribe
          - AutoResponder
          - AddressChange
          - DnsError
          - SpamNotification
          - OpenRelayTest
          - Unknown
          - SoftBounce
          - VirusNotification
          - MailFrontier Matador.
          - BadEmailAddress
          - SpamComplaint
          - ManuallyDeactivated
          - Unconfirmed
          - Blocked
          - SMTPApiError
          - InboundError
          - DMARCPolicy
          - TemplateRenderingFailed
      - name: inactive
        description: Filter by emails that were deactivated by Postmark due to the bounce. Set to true or false. If this isn't specified it will return both active and inactive.
        in: query
        schema:
          type: boolean
      - name: emailFilter
        in: query
        description: Filter by email address
        schema:
          type: string
          format: email
      - name: messageID
        description: Filter by messageID
        in: query
        schema:
          type: string
      - name: tag
        description: Filter by tag
        in: query
        schema:
          type: string
      - name: todate
        in: query
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        schema:
          type: string
          format: date
      - name: fromdate
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        in: query
        schema:
          type: string
          format: date
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BounceSearchResponse'
        422:
          $ref: '#/components/responses/422'
        500:
          $ref: '#/components/responses/500'
  /bounces/{bounceid}:
    get:
      operationId: getSingleBounce
      tags:
      - Bounces API
      summary: Postmark Get a single bounce
      parameters:
      - name: X-Postmark-Server-Token
        required: true
        description: The token associated with the Server on which this request will operate.
        in: header
        schema:
          type: string
      - name: bounceid
        in: path
        description: The ID of the bounce to retrieve.
        required: true
        schema:
          type: integer
          format: int64
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BounceInfoResponse'
        422:
          $ref: '#/components/responses/422'
        500:
          $ref: '#/components/responses/500'
  /bounces/{bounceid}/dump:
    get:
      tags:
      - Bounces API
      summary: Postmark Get bounce dump
      parameters:
      - name: X-Postmark-Server-Token
        required: true
        description: The token associated with the Server on which this request will operate.
        in: header
        schema:
          type: string
      - name: bounceid
        in: path
        description: The ID for the bounce dump to retrieve.
        required: true
        schema:
          type: integer
          format: int64
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BounceDumpResponse'
        422:
          $ref: '#/components/responses/422'
        500:
          $ref: '#/components/responses/500'
  /bounces/{bounceid}/activate:
    put:
      operationId: activateBounce
      tags:
      - Bounces API
      summary: Postmark Activate a bounce
      parameters:
      - name: X-Postmark-Server-Token
        required: true
        description: The token associated with the Server on which this request will operate.
        in: header
        schema:
          type: string
      - name: bounceid
        in: path
        description: The ID of the Bounce to activate.
        required: true
        schema:
          type: integer
          format: int64
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BounceActivationResponse'
        422:
          $ref: '#/components/responses/422'
        500:
          $ref: '#/components/responses/500'
components:
  schemas:
    BounceActivationResponse:
      properties:
        Message:
          type: string
        Bounce:
          $ref: '#/components/schemas/BounceInfoResponse'
    BounceSearchResponse:
      description: ''
      properties:
        TotalCount:
          type: integer
        Bounces:
          type: array
          items:
            $ref: '#/components/schemas/BounceInfoResponse'
    BounceInfoResponse:
      properties:
        ID:
          type: string
        Type:
          type: string
        TypeCode:
          type: integer
        Name:
          type: string
        Tag:
          type: string
        MessageID:
          type: string
        Description:
          type: string
        Details:
          type: string
        Email:
          type: string
          format: email
        BouncedAt:
          type: string
          format: date-time
        DumpAvailable:
          type: boolean
        Inactive:
          type: boolean
        CanActivate:
          type: boolean
        Subject:
          type: string
        Content:
          type: string
    BounceDumpResponse:
      properties:
        Body:
          description: Raw source of bounce. If no dump is available this will return an empty string.
          type: string
    DeliveryStatsResponse:
      description: ''
      properties:
        InactiveMails:
          type: integer
        Bounces:
          type: array
          items:
            $ref: '#/components/schemas/BounceCountElement'
    BounceCountElement:
      properties:
        Name:
          type: string
        Count:
          type: integer
        Type:
          type: string