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

# List volumes

`GET /v3/volumes`

Lists summary information for all Block Storage volumes

## Query parameters

- `all_tenants` string
- `sort` string
- `sort_key` string
- `sort_dir` 'asc' | 'desc'
- `limit` integer
- `offset` integer
- `marker` string
- `with_count` boolean
- `created_at` string
- `updated_at` string
- `consumes_quota` boolean

## Response `200`

OK

- VolumesSimple
  - `volumes` VolumeSimple[]
    - `id` string, uuid — The UUID of the volume
    - `name` string
  - `volumes_links` Link[]
    - `href` string, uri
    - `rel` string
    - `type` string
  - `count` integer — Total count of volumes (microversion 3.45+)

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/platform9/apis/cluster-blueprint-api.md) · [All operations](https://skmtc.net/platform9/apis/cluster-blueprint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/platform9/cluster-blueprint-api/revisions/708ad90fe444/schema)