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

---

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