---
title: "Retrieve Message Opens"
method: GET
path: "/messages/outbound/opens/{messageid}"
tags: ["Messages API"]
---

# Retrieve Message Opens

`GET /messages/outbound/opens/{messageid}`

## Path parameters

- `messageid` string, required

## Query parameters

- `count` integer, required
- `offset` integer, required

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