---
title: "List all volumes."
method: GET
path: "/v1/{tenantId}/volumes"
tags: ["Volume"]
---

# List all volumes.

`GET /v1/{tenantId}/volumes`

## Request

- Base URL: `https://virtserver.swaggerhub.com/open83/multi-cloud/1.0.0`
- URL: `https://virtserver.swaggerhub.com/open83/multi-cloud/1.0.0/v1/{tenantId}/volumes`
- Auth: none declared

## Query parameters

- `backendId` string
- `offset` integer
- `limit` integer
- `sort` string

## Response `200`

successful operation.

- object
  - `volumes` VolumeResult[]
    - `Id` string: The volume ID, generated by server
    - `CreatedAt` string: The time of creation of the volume.
    - `UpdatedAt` string: The time at which the volume was updated.
    - `TenantId` string: The tenant UUID in a multi-tenancy environment.
    - `UserId` string: The user UUID in a multi-tenancy environment.
    - `BackendId` string: The backend ID
    - `Backend` string: The backend Name.
    - `Name` string: The volume name specified by user.
    - `Description` string: The volume description specified by user.
    - `Type` string: The volume type.
    - `Size` integer: The volume size.
    - `Region` string: The region for the volume.
    - `AvailabilityZone` string: The availability zone for the volume.
    - `Status` 'available' | 'creating' | 'inUse' | 'error' | 'updating' | 'deleting' | 'errorDeleting' | 'deleted': The volume status.
    - `Tags` Tag[]
      - `key` string: Key of the Tag object.
      - `Value` string: Value of the Tag object.
    - `SnapshotId` string: The volume snapshot id.
    - `Encrypted` boolean: Flag for encryted volume.
    - `EncryptedSettings` object: Encryted volume Keys.
    - `Metadata` object
      - `fields` VolumeFields
        - `CreationTimeAtBackend` object
          - `kind` object
            - `StringValue` string
        - `StartTimeAtBackend` object
          - `kind` object
            - `StringValue` string
        - `VolumeId` object
          - `kind` object
            - `StringValue` string
        - `Progress` object
          - `kind` object
            - `NumberValue` integer
  - `next` integer

## Changes

> 33 revisions in range; 3 not diffed.

- **2020-09-29** `a06e1dd6b63d`: 1 warning, 1 info
  - removed the optional property `fileshares` from the response with the `200` status
  - added the optional property `volumes` to the response with the `200` status
- **2020-08-29** `7299be026d62`: 1 info
  - endpoint added
- **2020-08-29** `443f565555ae`: 1 breaking
  - api path removed without deprecation
- **2020-06-28** `b65d8dab2470`: 1 info
  - endpoint added
- **2018-10-29** `50fa096a3906`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/changes/v1/:tenantId/volumes/get.md)

---

[API](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api.md) - [All operations](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/revisions/df048c8349b6?raw)