> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# In-App Campaign Stats

> Reach and engagement for an in-app campaign

Returns reach and engagement for an in-app campaign, counted from the messages it delivered. Requires the `campaigns:read` scope.

* `delivered`: contacts whose app received the message while they were in the audience.
* `displayed`: contacts the app showed it to (impressions, once per contact).
* `clicked` and `totalClicks`: contacts who clicked at least once, and every click.
* `dismissed`: contacts who closed it.
* `pushPermissionGranted` and `pushPermissionDenied`: for push primers, what contacts chose after the permission button.
* `buttons`: for custom HTML messages, how many contacts' first click hit each control (`buttonId`).

`audienceAtLaunch` is how many contacts matched the audience when it went live (for a scheduled campaign, counted again at go-live). Delivered can be lower (contacts who haven't opened the app yet) or higher (contacts who joined the audience later).

## Request

**campaignId** `string` *required*

The in-app campaign ID.

```bash theme={null}
curl -X GET "https://api.sequenzy.com/api/v1/in-app/campaigns/cmp_abc123/stats" \
  --header "Authorization: Bearer $SEQUENZY_API_KEY"
```

## Responses

```json 200 theme={null}
{
  "success": true,
  "campaignId": "cmp_abc123",
  "status": "sent",
  "state": "live",
  "audienceAtLaunch": 1200,
  "stats": {
    "delivered": 860,
    "displayed": 812,
    "clicked": 214,
    "totalClicks": 251,
    "dismissed": 402,
    "pushPermissionGranted": 0,
    "pushPermissionDenied": 0,
    "buttons": []
  }
}
```

```json 401 theme={null}
{
  "error": "Invalid API key"
}
```

```json 403 theme={null}
{
  "error": "API key is missing required scope: campaigns:read"
}
```

```json 404 theme={null}
{
  "error": "Campaign not found."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.