---
title: "Outbound message search"
method: GET
path: "/messages/outbound"
tags: ["Messages API"]
---

# Outbound message search

`GET /messages/outbound`

## Query parameters

- `count` integer, required
- `offset` integer, required
- `recipient` string, email
- `fromemail` string, email
- `tag` string
- `status` 'queued' | 'sent'
- `todate` string, date
- `fromdate` string, date

## Headers

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

## Response `200`

OK

- OutboundSearchResponse
  - `TotalCount` integer
  - `Messages` OutboundMessageDetail[]
    - `Tag` string
    - `MessageID` string
    - `To` EmailNameAddressPair[]
      - `Name` string
      - `Email` string
    - `Cc` EmailNameAddressPair[]
      - `Name` string
      - `Email` string
    - `Bcc` EmailNameAddressPair[]
      - `Name` string
      - `Email` string
    - `Recipients` string[]
    - `ReceivedAt` string, date-time
    - `From` string
    - `Subject` string
    - `Attachments` Attachment[]
      - `Name` string
      - `Content` string
      - `ContentType` string
      - `ContentID` string
    - `Status` string
    - `TrackOpens` boolean
    - `TrackLinks` 'None' | 'HtmlAndText' | 'HtmlOnly' | 'TextOnly'

## 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.dev/postmarkapp/apis/postmark-api.md) · [All operations](https://skmtc.dev/postmarkapp/apis/postmark-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/postmarkapp/postmark-api/revisions/fdae25f55e2e/schema)