---
title: "snapshot list"
slug: "snapshot-list"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
canonical: "docs.vastdata.com/snapshot-list"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# snapshot list

This command displays all [snapshots](/docs-5-3/docs/snapshots-and-local-backup) and their details.

##### Usage

```plaintext
snapshot list [--name NAME_CONTAINS]
              [--path PATH]
              [--expiration-time EXPIRATION_TIME]
              [--policy POLICY__NAME]
              [--state STATE]
              [--tenant-name NAME]
              [--tenant-id ID]
```

##### Options

| `--name NAME_CONTAINS` | Filters the list by snapshot name or part of the snapshot name. |
| --- | --- |
| `--path PATH` | Filters the list by path. |
| `--expiration-time EXPIRATION_TIME` | Filters the list by expiration time . |
| `--policy POLICY__NAME` | Filters the list to display snapshots created by a specified snapshot policy. Specify POLICY_NAME as the name of a snapshot policy. |
| `--state STATE` | Filters the list by state. |
| `--tenant-name NAME` | Filters the list by tenant. |
| `--tenant-id ID` | Filters the list by tenant. |

##### Example

```plaintext
vcli: admin> snapshot list
+----+---------------------------------------------------+------+---------------------------+-------+----------------+-----------------------------+----------------------+----------------------+------------------+-----------+
| ID | Name                                              | Path | Policy                    | Type  | Indestructible | Created                     | Expiration-time      | Aggregated Usage(GB) | Unique Usage(GB) | Tenant-id |
+----+---------------------------------------------------+------+---------------------------+-------+----------------+-----------------------------+----------------------+----------------------+------------------+-----------+
| 16 | default_protection_policy_2023-03-29_14_55_24_UTC | /    | None                      | local | False          | 2023-03-29T14:55:24.005000Z | Never                | 0.0                  | 0.0              | 1         |
| 26 | big_catalog_2023-03-29_15_40_00_UTC               | /    | Big catalog policy        | local | False          | 2023-03-29T15:40:00.005000Z | 2023-03-29T16:00:00Z | 0.2                  | 0.0              | None      |
+----+---------------------------------------------------+------+---------------------------+-------+----------------+-----------------------------+----------------------+----------------------+------------------+-----------+
```