---
title: "Get all volumes"
method: GET
path: "/v1/volumes"
tags: ["Volumes"]
---

# Get all volumes

`GET /v1/volumes`

## Query parameters

- `status` 'ordered' | 'attached' | 'attaching' | 'detached' | 'deleted' | 'cloning' | 'detaching' | 'deleting' | 'restoring' | 'created' | 'exported' | 'canceled' | 'canceling'

## Response `200`

Returns a list of all volumes

### Rate limits

This endpoint is rate limited to 120 requests per minute per project.

- GetVolumePublicResponseDto[]
  - `id` string, required — Volume ID
  - `instance_id` string, required — Instance ID
  - `instances` string[], required — Instance info the volume is attached to
  - `name` string, required — Volume name
  - `created_at` string, required — Volume creation date
  - `created_by_user_id` string
  - `status` 'ordered' | 'attached' | 'attaching' | 'detached' | 'deleted' | 'cloning' | 'detaching' | 'deleting' | 'restoring' | 'created' | 'exported' | 'canceled' | 'canceling', required — Volume status
  - `size` number, required — Volume size in GB
  - `is_os_volume` boolean, required — Is OS volume
  - `target` string, required — Volume target
  - `type` 'HDD' | 'NVMe' | 'HDD_Shared' | 'NVMe_Shared' | 'NVMe_Local_Storage' | 'NVMe_Shared_Cluster' | 'NVMe_OS_Cluster', required — Volume type
  - `location` string, required — Volume location
  - `ssh_key_ids` string[], required — Array of SSH key IDs that are linked to the volume if it is an OS volume
  - `pseudo_path` string, required — Volume pseudo path. Unique identifier for your filesystem
  - `create_directory_command` string, required — Create directory command
  - `mount_command` string, required — Mount command
  - `filesystem_to_fstab_command` string, required — Filesystem to fstab command
  - `contract` string, required — Volume contract type
  - `base_hourly_cost` number, required — Volume base hourly cost
  - `monthly_price` number, required — Volume monthly price
  - `currency` 'usd' | 'eur', required — Volume currency
  - `long_term` object, required — Long term contract details
  - `tags` TagResponseDto[], required
    - `id` string, required
    - `key` string, required
    - `value` string, required — Empty string for a freeform tag

---

[API](https://skmtc.net/datacrunch/apis/verda-cloud-public-api.md) · [All operations](https://skmtc.net/datacrunch/apis/verda-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datacrunch/verda-cloud-public-api/revisions/0d66c7340876/schema)