---
title: "List volumes, newest first."
method: GET
path: "/v1/volumes"
tags: ["volumes"]
---

# List volumes, newest first.

`GET /v1/volumes`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/volumes`
- Auth: HTTP bearer

## Query parameters

- `cursor` string: Resource identifier (UUID).
- `limit` integer: Page size, 1 to 100.
- `state` 'creating' | 'ready' | 'failed' | 'deleting'
- `name` string: Your own handle for the resource. Letters, digits, dot, dash, underscore.

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, required
    - `kind` 'volume', required
    - `status` string, required
    - `state` 'creating' | 'ready' | 'failed' | 'deleting' | 'deleted', required
    - `name` string, nullable
    - `sizeMiB` integer, required
    - `usedMiB` integer, nullable
    - `backedUp` boolean, required: A volume lives on one host's disks. It is backed up off that host daily unless you turn that off, and whenever you ask; backedUp is true once a backup has been copied off the host and checked. Writes since the last backup are not in it. A backup is crash-consistent: what a program had not yet written to the disk is not in it.
    - `backups` object
      - `daily` boolean: Whether a backup is made each day.
      - `retentionDays` integer: How long each daily backup is kept.
      - `lastReadyAt` string, nullable: When the newest ready backup was taken.
    - `restoredFrom` string, nullable: The backup this volume was made from.
    - `attachments` object[]
      - `sandboxId` string
      - `mode` 'rw' | 'snapshot'
      - `path` string
      - `attachedAt` string
    - `createdAt` string
  - `nextCursor` string, nullable, required: Pass as cursor; null ends the list.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)