---
title: "Lists all disks in the project and returns their details."
method: GET
path: "/projects/{project_id}/storage/disks"
tags: ["Disks"]
---

# Lists all disks in the project and returns their details.

`GET /projects/{project_id}/storage/disks`

Size of disks will be in gibibytes (GiB)

## Path parameters

- `project_id` string, required

## Query parameters

- `disk_ids` string[]
- `location` string
- `disk_names` string[]
- `exclude_os` boolean

## Response `200`

- ListDisksResponseV1
  - `items` DiskV1[], required
    - `attached_to` VMAttachmentV1[], required — VMs the disk is currently attached to.
      - `attachment_type` string, required
      - `mode` string
      - `vm_id` string, required — ID of the VM the disk is attached to.
    - `block_size` integer, required — Block size of the disk, in bytes: 512 or 4096.
    - `created_at` string, required — Creation timestamp of the disk, in RFC3339 format.
    - `dns_name` string — DNS name used to mount the disk. Populated only for shared-volume disks.
    - `id` string, required — ID of the disk.
    - `location` string, required — Location where the disk is provisioned.
    - `name` string, required — Name of the disk.
    - `serial_number` string, required — Serial number assigned to the disk.
    - `size` string, required — Storage capacity of the disk, given as a size and unit in the format [Size][Unit], for example 100GiB or 1TiB.
    - `type` string, required — Type of the disk: persistent-ssd or shared-volume.
    - `updated_at` string, required — Last update timestamp of the disk, in RFC3339 format.
    - `vips` string[] — Virtual IP addresses used to mount the disk. Populated only for shared-volume disks.

## Other responses

- `401` — Error Authentication Failed
- `403` — Error Permissions
- `500` — Error Internal Server

---

[API](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway.md) · [All operations](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crusoecloud/crusoe-cloud-api-gateway/versions/a3fd2dedc72b/schema)