---
title: "List volumes"
method: GET
path: "/volumes"
tags: ["Volume"]
---

# List volumes

`GET /volumes`

## Query parameters

- `filters` string, json

## Response `200`

Summary volume data that matches the query

- VolumeListResp
  - `Volumes` VolumeInfo[], required — List of volumes
    - `Name` string — Name is the name of the volume.
    - `Driver` string — Driver is the Driver name used to create the volume.
    - `Mountpoint` string — Mountpoint is the location on disk of the volume.
    - `CreatedAt` string, dateTime — Date/Time the volume was created.
    - `Status` object — Status provides low-level status information about the volume.
    - `Labels` object — Labels is metadata specific to the volume.
    - `Scope` string — Scope describes the level at which the volume exists (e.g. `global` for cluster-wide or `local` for machine level)
  - `Warnings` string[], required — Warnings that occurred when fetching the list of volumes

## Other responses

- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/aliyun/apis/pouch-engine-api.md) · [All operations](https://skmtc.dev/aliyun/apis/pouch-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aliyun/pouch-engine-api/revisions/36d75b2825fc/schema)