---
title: "Get all snapshots in the workspace, optionally filtered by project or environment"
method: GET
path: "/workspaces/{workspace_domain}/sandboxes/snapshots"
tags: ["Sandbox API"]
---

# Get all snapshots in the workspace, optionally filtered by project or environment

`GET /workspaces/{workspace_domain}/sandboxes/snapshots`

## Path parameters

- `workspace_domain` string, required

## Query parameters

- `project_name` string
- `environment_id` string

## Response `200`

- SnapshotsView
  - `url` string — API endpoint to GET this object
  - `html_url` string — Web URL to view this object in Buddy.works
  - `snapshots` ShortSnapshotView[] — Collection of snapshots
    - `url` string — API endpoint to GET this object
    - `html_url` string — Web URL to view this object in Buddy.works
    - `id` string — The ID of the snapshot
    - `name` string — Snapshot name
    - `size` integer — Snapshot size in GB
    - `status` 'CREATING' | 'CREATED' | 'DELETING' | 'FAILED' — Snapshot status
    - `create_date` string, date-time — Snapshot creation date

## Changes

- **2026-08-25** `fa785a68f09d` — 4 info
  - the security scope `SANDBOX_READ` was added to the endpoint's security scheme `oauth2`
  - the security scope `SANDBOX_MANAGE` was removed from the endpoint's security scheme `oauth2`
  - added the new optional `query` request parameter `environment_id`
  - the `query` request parameter `project_name` became optional

[Change history](https://skmtc.dev/buddy/apis/buddy-api/changes/workspaces/:workspace_domain/sandboxes/snapshots/get.md)

---

[API](https://skmtc.dev/buddy/apis/buddy-api.md) · [All operations](https://skmtc.dev/buddy/apis/buddy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/buddy/buddy-api/revisions/fa785a68f09d/schema)