---
title: "Get a shared volume by ID"
method: GET
path: "/compute/clusters/storage/volumes/{volume_id}"
tags: ["SharedVolumeService"]
---

# Get a shared volume by ID

`GET /compute/clusters/storage/volumes/{volume_id}`

Retrieve information about a specific shared volume.

## Path parameters

- `volume_id` string, required — The ID of the volume to retrieve

## Response `200`

OK

- GPUClustersSharedVolume
  - `volume_id` string, required — ID of the volume.
  - `volume_name` string, required — User provided name of the volume.
  - `size_tib` integer, required — Size of the volume in TiB.
  - `status` 'scheduled' | 'available' | 'bound' | 'provisioning' | 'deleting' | 'failed' | 'access_revoked' | 'unknown', required — Current status of the shared volume.

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/92114e606090/schema)
