---
title: "GET /v1/snapshots/list"
method: GET
path: "/v1/snapshots/list"
---

# GET /v1/snapshots/list

`GET /v1/snapshots/list`

## Query parameters

- `page` number — Page number
- `page_size` number — Page size

## Response `200`

List snapshots belonging to the authenticated user

- ListSnapshotsResponse
  - `data` SnapshotListItem[], required — Array of snapshots
    - `id` string, required — Snapshot ID (Kubernetes UID)
    - `name` string, required — Snapshot name
    - `status` 'creating' | 'ready' | 'error' | 'pending_deletion', required — Snapshot status
    - `created_at` string, required — Creation timestamp
    - `size` string — Restore size
    - `depends_on` string[] — PVCs that depend on this snapshot (clones). Snapshot cannot be deleted until these are removed.
  - `pagination` SnapshotPagination, required — Pagination metadata
    - `page` number, required — Current page number
    - `page_size` number, required — Number of items per page
    - `total_pages` number, required — Total number of pages
    - `total_items` number, required — Total number of items

## Other responses

- `401` — Authentication required

## Changes

- **2026-01-26** `260daed67193` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/changes/v1/snapshots/list/get.md)

---

[API](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api.md) · [All operations](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/avm-codes/avm-sandbox-platform-api/revisions/260daed67193/schema)