---
title: "Get subscription stats"
method: GET
path: "/stakeholder-comms/cloudId/{cloudId}/api/subscribers/stats"
tags: ["Status Page"]
---

# Get subscription stats

`GET /stakeholder-comms/cloudId/{cloudId}/api/subscribers/stats`

Get subscription statistics for a status page item.

## Query parameters

- `itemId` string, required
- `type` string, required

## Response `200`

Returned if the request is successful.

- StakeholderCommsSubscriptionStatsResponse — Response containing subscription statistics for an item.
  - `stats` object — Subscription statistics.
    - `itemId` string — Identifier of the item.
    - `itemType` string — Type of the item.
    - `totalQuotaUsed` integer — Total quota used.
    - `countsByStatus` object[]
      - `status` string
      - `count` integer
    - `insertedAt` string, date-time
    - `updatedAt` string, date-time
  - `error` string — Error message, if the operation was not successful.

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the user does not have permission to view subscription stats.
- `500` — Returned if an internal server error occurs.

---

[API](https://skmtc.net/atlassian/apis/jsm-operations-api.md) · [All operations](https://skmtc.net/atlassian/apis/jsm-operations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jsm-operations-api/versions/ed65f017bcb8/schema)
