---
title: "Catalog lists the files and folders on volume with specified id."
method: GET
path: "/osd-volumes/catalog/{id}"
tags: ["volume"]
---

# Catalog lists the files and folders on volume with specified id.

`GET /osd-volumes/catalog/{id}`

Path is optional and default the behaviour is a catalog on the root of the volume.

## Path parameters

- `id` integer, required

## Query parameters

- `subfolder` string
- `depth` string

## Response `200`

volume catalog response

- CatalogResponse — unresolved $ref

## Changes

- **2018-07-21** `c3faa278ea9e` — 1 info
  - endpoint added
- **2017-12-05** `d79082f863d1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/libopenstorage/apis/osd-api/changes/osd-volumes/catalog/:id/get.md)

---

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