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

# List volumes

`GET /api/v1/volumes`

List volumes for the authenticated account. Filter by VM or region.

Pass `X-Project-ID` to scope the list to a single project. When omitted, returns volumes across every project the API key has access to.

## Query parameters

- `vm_id` string, uuid
- `region` 'us-east'
- `limit` integer
- `offset` integer

## Headers

- `X-Project-ID` string, uuid

## Response `200`

List of volumes

- object
  - `success` boolean
  - `data` Volume[]
    - `id` integer, required — Volume ID. Use this in `/volumes/{id}` for get, delete, attach, detach, resize.
    - `account_id` string, uuid — Account that owns the volume
    - `project_id` string, uuid — Project the volume belongs to
    - `product_vm` string, uuid — UUID of the VM the volume is currently attached to. Empty when detached.
    - `name` string, required — Volume display name
    - `volume_type` 'nvme', required — Storage class
    - `size` integer, required — Volume size in GB
    - `status` 'creating' | 'available' | 'attached' | 'deleting' | 'failed', required — Volume lifecycle status: - `creating` — being provisioned on the hypervisor - `available` — ready, not attached to any VM - `attached` — attached to a VM (see `product_vm`) - `deleting` — being torn down - `failed` — creation or attach failed
    - `price_per_hour` string — Hourly billing rate in USD
    - `region` 'us-east'
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `total` integer

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/revisions/2f4df56be77c/schema)