---
title: "Gets the recipients that opened a campaign."
method: GET
path: "/api/reports/{campaignId}/opens"
tags: ["Reports"]
---

# Gets the recipients that opened a campaign.

`GET /api/reports/{campaignId}/opens`

## Request

- Base URL: `https://api.gmass.co`
- URL: `https://api.gmass.co/api/reports/{campaignId}/opens`
- Auth: none declared

Specify the numeric campaign ID to retrieve the "opens" for that campaign. Open tracking must have been enabled.

## Path parameters

- `campaignId` integer, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- ApiListResponseOpen
  - `metadata` ApiListResponseMetadata
    - `links` object
    - `totalRecords` integer
    - `offset` integer
    - `limit` integer
    - `count` integer
  - `data` Open[]
    - `sender` string
    - `emailAddress` string
    - `openCount` integer
    - `lastOpenTime` string, date-time

---

[API](https://skmtc.dev/gmass/apis/gmass-api.md) - [All operations](https://skmtc.dev/gmass/apis/gmass-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gmass/apis/gmass-api/revisions/0498e4a9c765?raw)