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

# List snapshots

`GET /snapshots`

List all snapshots for the team

## Query parameters

- `sandboxID` string — Filter snapshots by source sandbox ID
- `name` string
- `limit` integer
- `nextToken` string

## Response `200`

Successfully returned snapshots

- SnapshotInfo[]
  - `snapshotID` string, required — Identifier of the snapshot template including the tag. Uses namespace/alias when a name was provided (e.g. team-slug/my-snapshot:default), otherwise falls back to the raw template ID (e.g. abc123:default).
  - `names` string[], required — Full names of the snapshot template including team namespace and tag (e.g. team-slug/my-snapshot:v2)

## Other responses

- `401` — Authentication error
- `500` — Server error

## Changes

- **2026-08-20** `e01b3f5506fe` — 2 info
  - added the optional property `error_code` to the response with the `401` status
  - added the optional property `error_code` to the response with the `500` status
- **2026-07-24** `93ed246a4c10` — 2 info
  - the endpoint scheme security `AdminApiKeyAuth AND AdminTeamAuth` was added to the API
  - the endpoint scheme security `Supabase1TokenAuth AND Supabase2TeamAuth` was removed from the API
- **2026-07-16** `7b36cca4e33d` — 1 info
  - added the new optional `query` request parameter `name`
- **2026-05-27** `e13ef89d456c` — 1 info
  - the endpoint scheme security `AuthProviderBearerAuth AND AuthProviderTeamAuth` was added to the API
- **2026-02-24** `0bcb69c4169b` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/snapshots/get.md)

---

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