---
title: "Who opened"
method: GET
path: "/v1/domains/{domain}/campaigns/opens"
tags: ["Recipients"]
---

# Who opened

`GET /v1/domains/{domain}/campaigns/opens`

## Request

- Base URL: `https://data.inboxpro.io`
- URL: `https://data.inboxpro.io/v1/domains/{domain}/campaigns/opens`
- Auth: HTTP bearer

Recipients who opened the campaign, those who opened most often first.

An unknown subject returns an empty list. Requires an API key with the **recipients:read** permission.

## Path parameters

- `domain` string, required

## Query parameters

- `subject` string, required
- `from` string, date
- `to` string, date
- `exclude_bots` boolean
- `page` integer
- `page_size` integer

## Response `200`

Default Response

- object
  - `domain` string, required
  - `subject` string, required
  - `period` object, required: The days these numbers cover (UTC, both inclusive).
    - `from` string, date, required
    - `to` string, date, required
  - `bots_excluded` boolean, required
  - `data_as_of` string, date-time, required: Numbers include activity up to this moment. Recent hours may still change slightly.
  - `pagination` object, required: Where this page sits in the full result.
    - `page` integer, required
    - `page_size` integer, required
    - `total` integer, required: Total rows across all pages.
  - `recipients` object[], required
    - `email` string, required: Recipient email address.
    - `opens` integer, required: How many times they opened it.

## Other responses

- `400`: A parameter is missing or invalid.
- `401`: The API key is missing, invalid, or revoked.
- `403`: This API key does not have access to recipient-level data.
- `404`: The domain is not one of your sending domains.
- `429`: Too many requests in a short time, or the daily request quota is used up.
- `503`: Stats are briefly unavailable. Retry after a short wait.

---

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