---
title: "List block storage snapshots"
method: GET
path: "/block-storage-snapshot"
tags: ["block-storage"]
---

# List block storage snapshots

`GET /block-storage-snapshot`

## Request

- Base URL: `https://api-ch-gva-2.exoscale.com/v2`
- URL: `https://api-ch-gva-2.exoscale.com/v2/block-storage-snapshot`
- Auth: none declared
- TypeScript: <https://skmtc.dev/exoscale/apis/exoscale-api/docs/block-storage-snapshot/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

200

- object
  - `block-storage-snapshots` BlockStorageSnapshot[]
    - `id` string, uuid: Snapshot ID
    - `name` string: Snapshot name
    - `size` integer: Snapshot size
    - `volume-size` integer: Original Volume size
    - `created-at` string, date-time: Snapshot creation date
    - `state` 'partially-destroyed' | 'destroying' | 'creating' | 'created' | 'promoting' | 'error' | 'destroyed' | 'allocated': Snapshot state
    - `labels` Labels
    - `block-storage-volume` BlockStorageVolumeRef: Target block storage volume
      - `id` string, uuid: Block storage volume ID

## Changes

- **2025-01-18** `cf1e7ba7143f`: 1 breaking
  - the `block-storage-snapshots/items/size` response property's min was decreased from `10.00` to `1.00` for the response status `200`
- **2024-05-22** `d1903c399d90`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/block-storage-snapshot/get.md)

---

[API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)