# VolumeList

> A page of Volume objects.

A page of Volume objects.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `data` * | array of [Volume](/docs/api/objects/volume/) |  |
| `next_cursor` * | string or null | Pass as `cursor` to get the next page; null on the last page. |
| `has_more` * | boolean |  |

\* always present

## Example

```json
{
  "data": [
    {
      "id": "vol_01jbx2m9k7q4r8t5v6w3y0z1vl",
      "environment_id": "env_01jbx2m9k7q4r8t5v6w3y0z1en",
      "name": "rota-cache",
      "service_id": "svc_01jbx2m9k7q4r8t5v6w3y0z1rw",
      "mount_path": "/data",
      "size_gb": 5,
      "used_bytes": 734003200,
      "used_percent": 13.7,
      "ha": false,
      "status": "attached",
      "resilience_note": "This volume is on one server. Turn on HA for automatic failover.",
      "backups": {
        "last_snapshot_at": "2026-10-23T14:00:00Z",
        "last_offsite_at": "2026-10-23T03:00:00Z"
      },
      "managed_by_manifest": true,
      "created_at": "2026-10-22T09:30:00Z"
    }
  ],
  "next_cursor": "string",
  "has_more": false
}
```

## Used by

- [List volumes](/docs/api/volumes/#list-volumes)
