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

# List Volumes

`GET /volumes`

Gets an array of available volumes under the parent catalog and schema.
There is no guarantee of a specific ordering of the elements in the array.

## Query parameters

- `catalog_name` string, required
- `schema_name` string, required
- `max_results` integer
- `page_token` string

## Response `200`

The volume list was successfully retrieved

- ListVolumesResponseContent
  - `volumes` VolumeInfo[]
    - `catalog_name` string — The name of the catalog where the schema and the volume are
    - `schema_name` string — The name of the schema where the volume is
    - `name` string — The name of the volume
    - `comment` string — The comment attached to the volume
    - `created_at` integer — Time at which this volume was created, in epoch milliseconds.
    - `updated_at` integer — Time at which this volume was last modified, in epoch milliseconds.
    - `volume_id` string — Unique identifier for the volume
    - `volume_type` 'MANAGED' | 'EXTERNAL' — The type of the volume
    - `storage_location` string — The storage location of the volume
    - `full_name` string — Full name of volume, in form of __catalog_name__.__schema_name__.__volume_name__.
  - `next_page_token` string — Opaque token to retrieve the next page of results. Absent if there are no more pages. __page_token__ should be set to this value for the next request to retrieve the next page of results.

---

[API](https://skmtc.net/unitycatalog/apis/unity-catalog-api.md) · [All operations](https://skmtc.net/unitycatalog/apis/unity-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unitycatalog/unity-catalog-api/versions/afb7536b3c70/schema)