---
title: "List your snapshots"
method: GET
path: "/snapshots"
tags: ["Snapshots"]
---

# List your snapshots

`GET /snapshots`

## Request

- Base URL: `https://sandbox-as-a-service.com/v1`
- URL: `https://sandbox-as-a-service.com/v1/snapshots`
- Auth: HTTP bearer

Snapshots you have captured, newest first. Deleted snapshots are not listed unless asked for.

## Query parameters

- `sandbox_id` string
- `limit` integer
- `include_deleted` boolean

## Response `200`

A page of snapshots.

- object
  - `object` 'list'
  - `data` Snapshot[]
    - `object` 'snapshot'
    - `id` string
    - `sandbox_id` string
    - `name` string, nullable
    - `status` 'pending' | 'available' | 'failed' | 'deleted': Capture lifecycle: `pending` while the image is being created, `available` once it is restorable, `failed` if the capture could not finish, `deleted` once it is gone.
    - `size` 'small' | 'medium' | 'large'
    - `created_at` string, date-time
    - `available_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable: When the snapshot is deleted automatically (retention).
    - `deleted_at` string, date-time, nullable

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api.md) · [All operations](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api/revisions/4f1ea2cf8333?raw)