---
title: "List subscriptions"
method: GET
path: "/api/v1/subscriptions"
tags: ["Subscriptions"]
---

# List subscriptions

`GET /api/v1/subscriptions`

Returns aggregated MQTT subscriptions and AMQP 0.9.1 active consumer
filters grouped by filter, with subscriber count and max QoS for each
row. By default, only connected clients are included
(`state=connected`).

## Query parameters

- `state` 'all' | 'connected' | 'disconnected'
- `prefix` string
- `limit` integer
- `page_token` string

## Response `200`

Paginated list of aggregated subscriptions

- ListSubscriptionsResponse
  - `subscriptions` SubscriptionResponse[]
    - `filter` string — MQTT topic filter or AMQP 0.9.1 consumer filter
    - `subscriber_count` integer — Number of matching MQTT subscribers and AMQP 0.9.1 consumers
    - `max_qos` integer — Highest QoS observed for the filter
  - `next_page_token` string — Cursor for the next page (empty if no more results)

## Other responses

- `400` — Invalid query parameters
- `405` — Method not allowed
- `503` — Broker not available

## Changes

- **2026-03-19** `bca7eaae3f1f` — 1 info
  - endpoint added
- **2026-03-18** `6fc20085ce13` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/absmach/apis/fluxmq-admin-api/changes/api/v1/subscriptions/get.md)

---

[API](https://skmtc.dev/absmach/apis/fluxmq-admin-api.md) · [All operations](https://skmtc.dev/absmach/apis/fluxmq-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/absmach/fluxmq-admin-api/revisions/c0dcbfa396c1/schema)