---
title: "List snapshots for a sandbox"
method: GET
path: "/sandboxes/{id}/snapshots"
tags: ["Snapshots"]
---

# List snapshots for a sandbox

`GET /sandboxes/{id}/snapshots`

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Paginated snapshots

- PaginatedSnapshotsEnvelope
  - `message` string, required
  - `data` PaginatedSnapshots, required
    - `data` Snapshot[], required
      - `id` string, required
      - `sandbox_id` string, required
      - `name` string, required
      - `image_tag` string, required
      - `source_template` string, required
      - `status` 'creating' | 'ready' | 'failed', required
      - `failure_reason` string, nullable
      - `size_bytes` integer, nullable
      - `created_at` string, date-time, required
    - `totalCount` integer, required
    - `currentPage` integer, required
    - `totalPages` integer, required
    - `limit` integer, required

## Other responses

- `400` — Validation error / invalid state transition
- `404` — Sandbox or related resource not found (also returned when owned by another user)

---

[API](https://skmtc.net/brimblehq/apis/brimble-sandbox-api.md) · [All operations](https://skmtc.net/brimblehq/apis/brimble-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brimblehq/brimble-sandbox-api/versions/7fe2df041597/schema)