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

# Get a shared volume by ID

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

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v1/compute/clusters/storage/volumes/{volume_id}`
- Auth: HTTP bearer

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.

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/compute/clusters/storage/volumes/:volume_id/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)