---
title: "List Status Page Subscriptions"
method: GET
path: "/status_pages/{id}/subscriptions"
tags: ["Status Pages"]
---

# List Status Page Subscriptions

`GET /status_pages/{id}/subscriptions`

List Subscriptions for a Status Page by Status Page ID.

Scoped OAuth requires: `status_pages.read`

## Path parameters

- `id` string, required

## Query parameters

- `status` 'active' | 'pending'
- `channel` 'webhook' | 'email' | 'slack'

## Headers

- `Accept` string, required

## Response `200`

OK

- object
  - `offset` integer — Echoes offset pagination property.
  - `limit` integer — Echoes limit pagination property.
  - `more` boolean — Indicates if there are additional records to return
  - `total` integer, nullable — The total number of records matching the given query.
  - `subscriptions` StatusPageSubscription[]
    - `channel` 'webhook' | 'email' | 'slack' — The channel of the subscription.
    - `contact` string — The subscriber's contact - email address, webhook URL, etc...
    - `id` string — The ID of the Subscription.
    - `self` string — The path in which the Subscription resource is accessible.
    - `status` 'active' | 'pending' | 'suspended' — The status of the Subscription.
    - `status_page` object — Status Page
      - `id` string, required — Status page unique identifier
      - `type` string — A string that determines the schema of the object.
    - `subscribable_object` object — The subscribed entity for a given subscription.
      - `id` string — The ID of the subscribed entity.
      - `type` 'status_page' | 'status_page_service' | 'status_page_post' — The type of the subscribed entity.
    - `type` string — A string that determines the schema of the object.

## Other responses

- `400` — Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.
- `401` — Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `404` — The requested resource was not found.
- `429` — Too many requests have been made, the rate limit has been reached.

---

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