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

# Inbound message search

`GET /messages/inbound`

## Query parameters

- `count` integer, required
- `offset` integer, required
- `recipient` string, email
- `fromemail` string, email
- `subject` string
- `mailboxhash` string
- `tag` string
- `status` 'blocked' | 'processed' | 'queued' | 'failed' | 'scheduled'
- `todate` string, date
- `fromdate` string, date

## Headers

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

## Response `200`

OK

- InboundSearchResponse
  - `TotalCount` integer
  - `InboundMessages` InboundMessageDetail[]
    - `From` string
    - `FromName` string
    - `FromFull` object
      - `Email` string
      - `Name` string
    - `To` string
    - `ToFull` EmailNameAddressPair[]
      - `Name` string
      - `Email` string
    - `Cc` string
    - `CcFull` EmailNameAddressPair[]
      - `Name` string
      - `Email` string
    - `ReplyTo` string
    - `OriginalRecipient` string
    - `Subject` string
    - `Date` string
    - `MailboxHash` string
    - `Tag` string
    - `Attachments` Attachment[]
      - `Name` string
      - `Content` string
      - `ContentType` string
      - `ContentID` string
    - `MessageID` string
    - `Status` 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.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)