---
title: "Get a snapshot"
method: GET
path: "/v2/sandboxes/snapshots/{snapshotId}"
tags: ["sandboxes"]
---

# Get a snapshot

`GET /v2/sandboxes/snapshots/{snapshotId}`

Retrieves detailed information about a specific snapshot, including its creation time, size, expiration date, and the source session it was created from.

## Path parameters

- `snapshotId` string, required — The unique identifier of the snapshot to retrieve.

## Query parameters

- `teamId` string
- `slug` string

## Response `200`

- object
  - `snapshot` Snapshot, required — This object contains information related to a Snapshot of a Vercel Sandbox session (v2 API).
    - `id` string, required — The unique identifier of the snapshot.
    - `sourceSessionId` string, required — The unique identifier of the session from which the snapshot was created.
    - `region` string — The region where the snapshot is stored.
    - `status` 'created' | 'deleted' | 'failed', required — The status of the snapshot.
    - `sizeBytes` number, required — The size of the snapshot in bytes.
    - `expiresAt` number — The time when the snapshot will expire, in milliseconds since the epoch. If not set, the snapshot does not have any expiration.
    - `createdAt` number, required — The time when the snapshot was created, in milliseconds since the epoch.
    - `updatedAt` number, required — The last time the snapshot was updated, in milliseconds since the epoch.
    - `lastUsedAt` number, required — The last time the snapshot was used (e.g. to resume or create a sandbox), in milliseconds since the epoch. Falls back to `createdAt` for older snapshots that predate this field.
    - `creationMethod` 'automatic' | 'manual' — The method used to create the snapshot.
    - `parentId` string — The unique identifier of the parent snapshot, if this snapshot was created from another snapshot.

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`
- `429`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)