---
title: "List Subscribers"
method: GET
path: "/subscribers"
tags: ["Subscribers"]
---

# List Subscribers

`GET /subscribers`

## Query parameters

- `filter[meta][key]` unknown
- `per_page` integer
- `page` integer
- `filter[meta]` string
- `sort` string[]
- `filter[email]` string
- `filter[global]` boolean
- `include` string[]

## Response `200`

Paginated set of `Subscriber`

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error

## Changes

> 30 revisions in range; 7 could not be searched.

- **2026-07-13** `408fd86def03` — 1 breaking, 6 info
  - the response property `included/items/attributes/meta` became optional for the status `200`
  - added the new optional `query` request parameter `filter[meta]`
  - added the new optional `query` request parameter `filter[meta][key]`
  - added the enum value `meta` to the property `items/` of the `query` request parameter `include`
  - …3 more
- **2026-07-10** `02682dfc9449` — 3 warning, 3 info
  - added the new `Major outage` enum value to the `included/items/attributes/status/human` response property for the response status `200`
  - added the new `Partial outage` enum value to the `included/items/attributes/status/human` response property for the response status `200`
  - added the new `Performance issues` enum value to the `included/items/attributes/status/human` response property for the response status `200`
  - removed the `Major Outage` enum value from the `included/items/attributes/status/human` response property for the response status `200`
  - …2 more
- **2026-07-10** `4e4308be5bcf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cachethq/apis/cachet/changes/subscribers/get.md)

---

[API](https://skmtc.dev/cachethq/apis/cachet.md) · [All operations](https://skmtc.dev/cachethq/apis/cachet/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cachethq/cachet/revisions/7f89fdcf710a/schema)