---
title: "List Volumes"
method: GET
path: "/apps/{appId}/volumes"
tags: ["Volumes"]
---

# List Volumes

`GET /apps/{appId}/volumes`

## Request

- Base URL: `https://api.bunny.net/mc`
- URL: `https://api.bunny.net/mc/apps/{appId}/volumes`
- Auth: API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/magic-containers-api/docs/apps/:appId/volumes/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all volume templates and their instances for an application, including usage statistics.

## Path parameters

- `appId` string, required

## Response `200`

Volumes were successfully retrieved.

- ListVolumesResponse: List volumes response
  - `items` VolumeInList[]
    - `name` string
    - `id` string
    - `size` number, double
    - `totalUsage` number, double
    - `totalInstancesCount` integer
    - `attachedInstancesCount` integer
    - `containersCount` integer
    - `volumeInstances` VolumeInstance[]
      - `id` string
      - `attachedPods` string[]
      - `attachedContainers` string[]
      - `region` string
      - `status` 'unknown' | 'attached' | 'detached' | 'extending' | 'deleting' | 'creating' | 'notScheduled' | 'scheduled' | 'failed' | 'maintenance'
      - `size` number, double
      - `usage` number, double
      - `set` string
  - `meta` ListMeta
    - `totalItems` integer
  - `cursor` string, nullable
  - `summary` ListVolumesSummary
    - `totalPods` integer
    - `totalContainers` integer
    - `totalStorage` number, double

## Other responses

- `401`: User is unauthorized.
- `500`: Unexpected server error.

## Changes

- **2026-08-08** `0054dcaa32fb`: 1 warning, 1 info
  - added the new `maintenance` enum value to the `items/items/volumeInstances/items/status` response property for the response status `200`
  - added the optional property `items/items/volumeInstances/items/set` to the response with the `200` status
- **2026-04-26** `62fb48c758fb`: 9 warning, 11 info
  - added the new `attached` enum value to the `items/items/volumeInstances/items/status` response property for the response status `200`
  - added the new `creating` enum value to the `items/items/volumeInstances/items/status` response property for the response status `200`
  - added the new `deleting` enum value to the `items/items/volumeInstances/items/status` response property for the response status `200`
  - added the new `detached` enum value to the `items/items/volumeInstances/items/status` response property for the response status `200`
  - …16 more

[Operation history](https://skmtc.dev/bunny/apis/magic-containers-api/changes/apps/:appId/volumes/get.md)

---

[API](https://skmtc.dev/bunny/apis/magic-containers-api.md) - [All operations](https://skmtc.dev/bunny/apis/magic-containers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/magic-containers-api/revisions/7bb58a0591b0?raw)