---
title: "Get volume by id"
method: GET
path: "/v1/volumes/{volume_id}"
tags: ["Volumes"]
---

# Get volume by id

`GET /v1/volumes/{volume_id}`

## Path parameters

- `volume_id` string, required

## Response `200`

Returns volume details

- union
  - 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
  - GetVolumeInTrashPublicResponseDto
    - `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
    - `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
    - `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
    - `tags` TagResponseDto[], required
      - `id` string, required
      - `key` string, required
      - `value` string, required — Empty string for a freeform tag
    - `deleted_at` string, required — Volume deletion date
    - `is_permanently_deleted` boolean, required — Is volume permanently deleted

---

[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)