---
title: "list volumes"
method: GET
path: "/api/v0/volumes/"
tags: ["Volumes"]
---

# list volumes

`GET /api/v0/volumes/`

Retrieve information about all volumes rented by you.

CLI Usage: `vastai show volumes`

## Response `200`

Success response

- object
  - `volumes` Volume[]
    - `instances` object[] — List of instances using this volume
    - `driver_version` string — NVIDIA driver version
    - `cuda_max_good` number — Maximum CUDA version supported
    - `machine_id` integer — Unique identifier for the machine
    - `public_ipaddr` string — Public IP address
    - `reliability2` number — Reliability score of the host
    - `host_id` integer — Unique identifier for the host
    - `cpu_name` string — Name/model of the CPU
    - `mobo_name` string — Name/model of the motherboard
    - `disk_space` number — Disk space in GB
    - `disk_name` string — Name/model of the disk
    - `inet_up` number — Upload internet speed in Mbps
    - `inet_down` number — Download internet speed in Mbps
    - `storage_total_cost` number — Total cost for storage
    - `os_version` string — Operating system version
    - `verification` string — Verification status
    - `static_ip` boolean — Whether the machine has a static IP
    - `cpu_arch` string — CPU architecture
    - `start_date` number — Start date as Unix timestamp
    - `id` integer — Unique identifier for the volume
    - `status` string — Current status of the volume

## Other responses

- `401` — Unauthorized
- `429` — Too Many Requests

---

[API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/revisions/4ed14f79f796/schema)