---
title: "Opens for all messages"
method: GET
path: "/messages/outbound/opens"
tags: ["Messages API"]
---

# Opens for all messages

`GET /messages/outbound/opens`

## Query parameters

- `count` integer, required
- `offset` integer, required
- `recipient` string
- `tag` string
- `client_name` string
- `client_company` string
- `client_family` string
- `os_name` string
- `os_family` string
- `os_company` string
- `platform` string
- `country` string
- `region` string
- `city` string

## Headers

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

## Response `200`

OK

- MessageOpenSearchResponse
  - `TotalCount` integer
  - `Opens` ExtendedMessageOpenEventInformation[]
    - `FirstOpen` boolean
    - `Client` object
      - `Name` string
      - `Company` string
      - `Family` string
    - `OS` object
      - `Name` string
      - `Company` string
      - `Family` string
    - `Platform` string
    - `UserAgent` string
    - `Geo` object
      - `CountryISOCode` string
      - `Country` string
      - `RegionISOCode` string
      - `Region` string
      - `City` string
      - `Zip` string
      - `Coords` string
      - `IP` string
    - `MessageID` string
    - `ReceivedAt` string, date-time
    - `Tag` string
    - `Recipient` string, email

## 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)