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

# Get Push Campaign Stats

> Read delivery and engagement stats for a push campaign

# Get Push Campaign Stats

Returns delivery and engagement stats for a push campaign. Test sends are excluded.

| Field | Meaning |
| - | - |
| `sent` | Contacts whose notification at least one push service accepted |
| `delivered` | Contacts whose device reported displaying it (browsers report automatically; apps report through the events endpoint) |
| `clicked` | Contacts who opened it |
| `failed` | Contacts whose every device rejected it, or whose credentials were refused |
| `skipped` | Contacts with no active device on a set-up platform, or stopped by a cancel |
| `devicesTargeted` / `devicesAccepted` | Device-level counts |

Requires the `campaigns:read` scope.

## Request

<ParamField path="campaignId" type="string" required>
  The push campaign ID.
</ParamField>

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

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "campaignId": "cmp_abc123",
    "status": "sent",
    "stats": {
      "total": 340,
      "pending": 0,
      "sent": 331,
      "failed": 4,
      "skipped": 5,
      "delivered": 210,
      "clicked": 48,
      "devicesTargeted": 402,
      "devicesAccepted": 389,
      "skipReasons": [
        {
          "reason": "no_active_device",
          "count": 5
        }
      ],
      "failureReasons": [
        {
          "reason": "all_devices_invalid",
          "count": 4
        }
      ]
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "This campaign is not a push campaign."
  }
  ```

  ```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."
  }
  ```
</ResponseExample>


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