---
title: "List all NVMeoF subsystems"
method: GET
path: "/api/nvmeof/subsystem"
tags: ["NVMe-oF Subsystem"]
---

# List all NVMeoF subsystems

`GET /api/nvmeof/subsystem`

## Query parameters

- `nqn` string
- `serial_number` string
- `gw_group` string
- `server_address` string
- `traddr` string

## Response `200`

OK

- object

## Other responses

- `400` — Operation exception. Please check the response body for details.
- `401` — Unauthenticated access. Please login first.
- `403` — Unauthorized access. Please check your permissions.
- `500` — Unexpected error. Please check the response body for the stack trace.

## Changes

- **2026-06-16** `1c8b90eca98f` — 2 info
  - added the new optional `query` request parameter `nqn`
  - added the new optional `query` request parameter `serial_number`
- **2026-06-10** `e5801ec0e794` — 2 warning
  - deleted the `query` request parameter `nqn`
  - deleted the `query` request parameter `serial_number`
- **2026-06-10** `ba49ede1b529` — 2 info
  - added the new optional `query` request parameter `nqn`
  - added the new optional `query` request parameter `serial_number`
- **2026-06-04** `a207937863ae` — 2 warning
  - deleted the `query` request parameter `nqn`
  - deleted the `query` request parameter `serial_number`
- **2026-06-02** `34d40e92ede1` — 2 info
  - added the new optional `query` request parameter `nqn`
  - added the new optional `query` request parameter `serial_number`

[Full history](https://skmtc.dev/ceph/apis/ceph-rest-api/changes/api/nvmeof/subsystem/get.md)

---

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