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

# List volumes

`GET /volumes`

Returns all storage volumes with their metadata and statistics.

## Response `200`

Storage volumes.

- VolumeMeta[]
  - `id` integer, required — Unique identifier of the volume.
  - `localPath` string, required — Absolute filesystem path of the volume data.
  - `usedSectors` integer, required — Number of sectors currently stored in the volume.
  - `totalSectors` integer, required — Maximum number of sectors the volume can store.
  - `readOnly` boolean, required — Whether the volume is read-only.
  - `available` boolean, required — Whether the volume is currently available for I/O operations.
  - `failedReads` integer — Number of failed sector read operations.
  - `failedWrites` integer — Number of failed sector write operations.
  - `successfulReads` integer — Number of successful sector read operations.
  - `successfulWrites` integer — Number of successful sector write operations.
  - `corruptSectors` integer — Number of sectors that failed to verify against their root while being read.
  - `status` string — Current volume status (unavailable, creating, resizing, removing, ready).
  - `errors` string[], nullable — Recent error messages from volume operations.

## Changes

- **2026-07-17** `08ff756929fc` — 1 info
  - added the optional property `items/allOf[#/components/schemas/VolumeStats]/corruptSectors` to the response with the `200` status
- **2025-10-08** `103993fc0091` — 1 warning
  - removed the optional property `items/allOf[#/components/schemas/VolumeStats]/corruptSectors` from the response with the `200` status

[Change history](https://skmtc.dev/siafoundation/apis/hostd-api/changes/volumes/get.md)

---

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