Postmark

Postmark Bounces API

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

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /deliverystats Summarize bounces and inactive addresses · Postmark Get delivery stats #
Ask an LLM
“How many of my recipient addresses are currently inactive because of bounces?”
“Can I see a breakdown of bounce totals by bounce type for my Postmark server?”
Tell an agent
Show the delivery stats summary for the server with token {server_token}.
Give me the count of inactive emails and bounce totals per type.
GET /bounces List bounced emails · Postmark Get bounces #
Ask an LLM
“Which emails bounced on my server last week?”
“Can I filter bounces to only the addresses that got deactivated?”
Tell an agent
List the first {count} bounces of type {type}.
Find bounces for {email} between {fromdate} and {todate}.
GET /bounces/{bounceid} Get details of one bounce · Postmark Get a single bounce #
Ask an LLM
“What exactly caused a particular bounce I'm looking at?”
“Can I see the full details of a single bounce by its ID?”
Tell an agent
Get the details of bounce {bounceid}.
Tell me why bounce {bounceid} happened and whether it can be reactivated.
GET /bounces/{bounceid}/dump Get the raw dump of a bounce · Postmark Get bounce dump #
Ask an LLM
“Can I see the raw SMTP source of a bounced message?”
“Where do I get the full bounce dump to debug why a message failed?”
Tell an agent
Get the raw dump for bounce {bounceid}.
Show the original bounce message source for bounce {bounceid}.
PUT /bounces/{bounceid}/activate Reactivate a bounced address · Postmark Activate a bounce #
Ask an LLM
“How do I start sending again to an address that was deactivated after a bounce?”
“Can I reactivate a recipient once they've fixed their mailbox?”
Tell an agent
Reactivate the address behind bounce {bounceid}.
Activate bounce {bounceid} so we can email that recipient again.

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: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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

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'
      operationId: getBouncesByBounceidDump
      x-operation-id-source: derived
  /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:
    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
    BounceSearchResponse:
      description: ''
      properties:
        TotalCount:
          type: integer
        Bounces:
          type: array
          items:
            $ref: '#/components/schemas/BounceInfoResponse'
    BounceActivationResponse:
      properties:
        Message:
          type: string
        Bounce:
          $ref: '#/components/schemas/BounceInfoResponse'
    BounceCountElement:
      properties:
        Name:
          type: string
        Count:
          type: integer
        Type:
          type: string
    DeliveryStatsResponse:
      description: ''
      properties:
        InactiveMails:
          type: integer
        Bounces:
          type: array
          items:
            $ref: '#/components/schemas/BounceCountElement'
    BounceDumpResponse:
      properties:
        Body:
          description: Raw source of bounce. If no dump is available this will return an empty string.
          type: string