> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novita.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get & List a Volume

Use the `novita.volume` methods to look up a single volume or list all volumes in your account. Both return volume metadata such as ID, name, quota, and usage.

***

## Get a volume

`novita.volume.getInfo()` (JS) / `novita.volume.get_info()` (Python) returns information about a single volume by its ID, including its access `token`. If the volume does not exist, a not-found error is raised.

```js JavaScript & TypeScript icon="js" theme={"system"}
import { Novita } from 'novita-sandbox'

const novita = new Novita()

const info = await novita.volume.getInfo('vol_123')
console.log(info.volumeId, info.name)
console.log('quota:', info.quotaSizeGiB, 'GiB,', info.quotaInodes, 'inodes')
console.log('token:', info.token)
```

```python Python icon="python" theme={"system"}
from novita_sandbox import Novita

novita = Novita()

info = novita.volume.get_info("vol_123")
print(info.volume_id, info.name)
print("quota:", info.quota_size_gib, "GiB,", info.quota_inodes, "inodes")
print("token:", info.token)
```

```bash CLI icon="terminal" theme={"system"}
novita volume get <volume_id>
```

## List volumes

`novita.volume.list()` returns all volumes in your account as a list of volume info (without the token).

```js JavaScript & TypeScript icon="js" theme={"system"}
import { Novita } from 'novita-sandbox'

const novita = new Novita()

const volumes = await novita.volume.list()
for (const vol of volumes) {
  console.log(`${vol.volumeId}  ${vol.name}  ${vol.quotaSizeGiB} GiB`)
}
```

```python Python icon="python" theme={"system"}
from novita_sandbox import Novita

novita = Novita()

volumes = novita.volume.list()
for vol in volumes:
    print(f"{vol.volume_id}  {vol.name}  {vol.quota_size_gib} GiB")
```

```bash CLI icon="terminal" theme={"system"}
novita volume list

# JSON output
novita volume list --output json
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.